Retrieve a single contract | Deel

curl -G https://api.letsdeel.com/rest/v2/contracts/37nex2x \
     -H "Authorization: Bearer <token>" \
     -d expand=cost_centers

{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "type": "ongoing_time_based",
    "title": "Software Development Contract",
    "client": {
      "team": {
        "id": "team-xyz789",
        "name": "Engineering Team"
      },
      "id": "team-abc123",
      "email": "client@example.com",
      "full_name": "Acme Corp",
      "legal_entity": {
        "id": "team-xyz789",
        "name": "Engineering Team",
        "type": "company",
        "email": "test@example.com",
        "subtype": "general-partnership",
        "vat_number": "123456789",
        "registration_number": "123456789"
      }
    },
    "status": "in_progress",
    "worker": {
      "id": "team-abc123",
      "email": "client@example.com",
      "country": "US",
      "full_name": "Acme Corp",
      "last_name": "Doe",
      "first_name": "John",
      "nationality": "US",
      "date_of_birth": "1990-01-01",
      "expected_email": "test@example.com",
      "alternate_email": [
        {
          "email": "test@example.com",
          "isVerified": true
        }
      ]
    },
    "created_at": "2022-01-01T00:00:00Z",
    "signatures": {
      "signed_at": "2022-01-01T00:00:00Z",
      "client_signature": "Jane Doe",
      "client_signed_at": "2022-01-01T00:00:00Z",
      "worker_signature": "Jane Doe",
      "worker_signed_at": "2022-01-01T00:00:00Z"
    },
    "start_date": "2022-01-01T00:00:00Z",
    "updated_at": "2022-05-02T00:00:00Z",
    "invitations": {
      "client_email": "client@example.com",
      "worker_email": "worker@example.com"
    },
    "is_archived": "false",
    "special_clause": "Special clause",
    "termination_date": "2022-01-01T00:00:00Z",
    "quote": {
      "benefits": [
        {
          "fee": 200.5,
          "name": "Health Insurance",
          "plan": "Premium",
          "price": 150.75,
          "fee_usd": 220,
          "currency": "USD",
          "price_usd": 170.5
        }
      ],
      "currency": "USD"
    },
    "location": "Spain",
    "job_title": "Backend Developer",
    "seniority": {
      "id": 1,
      "name": "Mid (Individual Contributor Level 2)",
      "level": 2
    },
    "external_id": "external_id",
    "who_reports": "client",
    "cost_centers": [
      {
        "name": "6P73USR022JKJ2KU1",
        "number": "553",
        "allocation_percentage": 100
      }
    ],
    "product_area": 1234,
    "custom_fields": [
      {
        "id": "64f65ef7-4d4d-4a26-b745-0398bb49f7f5",
        "name": "Employee ID",
        "value": "54234"
      }
    ],
    "notice_period": 30,
    "scope_of_work": "Scope of work",
    "work_schedule": {
      "days": [
        {
          "day": "MONDAY",
          "end": "17:00:00",
          "start": "09:00:00",
          "work_hours": 8
        }
      ],
      "name": "34ZNYKYL3G",
      "country": "IN",
      "worker_types": [
        "SALARIED_DIRECT_EMPLOYEE_PAYROLL"
      ],
      "effective_from": "2026-01-01T00:00:00.000",
      "work_schedule_type": "Fixed work schedule",
      "work_hours_per_week": 40,
      "employment_type": "FULL_TIME"
    },
    "fte_percentage": 1,
    "employment_type": "FULL_TIME",
    "contract_template": {
      "id": "37nex2x",
      "title": "UK Employment Contract 2022."
    },
    "work_statement_id": "123e4567-e89b-12d3-a456-426614174000",
    "employment_details": {
      "type": "full_time",
      "days_per_week": 5,
      "hours_per_day": 8,
      "probation_period": 30,
      "paid_vacation_days": 20
    },
    "compensation_details": {
      "scale": "hourly",
      "amount": "100",
      "cycle_end": 31,
      "frequency": "monthly",
      "currency_code": "GBP",
      "first_payment": "500",
      "cycle_end_type": "DAY_OF_MONTH",
      "first_payment_date": "2024-08-30T20:59:59.999+00:00",
      "gross_annual_salary": "50000",
      "gross_signing_bonus": "5000",
      "gross_variable_bonus": "5000"
    }
  }
}

Retrieves the full record for a specific contract by contract_id, including status, compensation, worker details, and metadata. Pass expand=cost_centers as a query parameter to include cost center data in the response. Token scopes: contracts:read

Authentication

AuthorizationBearer

## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Path parameters

contract_idstringRequired

Unique identifier of the contract.

Query parameters

expandenumOptional

Include cost centers in the response.

Allowed values:

Response

Successful operation.

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

1	curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2	-H 'Authorization: Bearer YOUR-TOKEN-HERE'