List job requests

GET

/vms/requisitions

GET

/rest/vms/requisitions

curl -G https://api.letsdeel.com/rest/vms/requisitions \
     -H "Authorization: Bearer <token>" \
     -d approval_status=APPROVED \
     -d contract_type=CONTRACTOR \
     --data-urlencode created_at_from=2026-01-01T00:00:00.000Z \
     --data-urlencode created_at_to=2026-06-30T00:00:00.000Z \
     -d cursor=eyJwcmV2aW91c1BhZ2VMYXN0SWQiOjEyMzR9 \
     --data-urlencode end_date_from=2026-09-01T00:00:00.000Z \
     --data-urlencode end_date_to=2026-12-31T00:00:00.000Z \
     -d limit=10 \
     -d locations=US \
     -d rate_scale=MONTHLY \
     -d request_type=GENERAL \
     -d search=engineer \
     -d sort_by=created_at \
     -d sort_order=ASC \
     --data-urlencode start_date_from=2026-09-01T00:00:00.000Z \
     --data-urlencode start_date_to=2026-12-31T00:00:00.000Z \
     -d status=ACTIVE \
     -d vendor_ids=3cfbb359-6084-46c0-9d3f-1ed1a1007a7a \
     -d work_mode=REMOTE

{
  "data": [
    {
      "id": "3cfbb359-6084-46c0-9d3f-1ed1a1007a7a",
      "title": "Senior Backend Engineer",
      "status": "ACTIVE",
      "vendors": [
        {
          "id": "7d4e1a26-9c83-4b57-a1f0-6e2b8d5c3097",
          "name": "Talent Partner Ltd.",
          "status": "APPROVED",
          "fee_type": "ONE_TIME_PERCENTAGE",
          "logo_url": "https://example.com/logo.png",
          "fee_value": 15,
          "created_at": "2026-07-02T09:00:00.000Z",
          "updated_at": "2026-07-06T08:20:00.000Z",
          "rejected_reason": "Rate below the agreed range.",
          "status_updated_at": "2026-07-05T12:00:00.000Z",
          "work_order_status": "SIGNED",
          "hirer_withdrawn_reason": "Job request closed early.",
          "vendor_withdrawn_reason": "No available candidates.",
          "work_order_status_updated_at": "2026-07-06T08:20:00.000Z"
        }
      ],
      "yoe_min": 5,
      "currency": "USD",
      "end_date": "2027-03-01T00:00:00.000Z",
      "quantity": 2,
      "rate_max": 9000,
      "rate_min": 7000,
      "locations": [
        "US"
      ],
      "work_mode": "REMOTE",
      "close_note": "Filled by an internal transfer.",
      "created_at": "2026-07-01T10:15:00.000Z",
      "job_family": "ENGINEERING",
      "rate_scale": "MONTHLY",
      "start_date": "2026-09-01T00:00:00.000Z",
      "updated_at": "2026-08-20T16:45:00.000Z",
      "description": "Build and maintain our payments platform.",
      "close_reason": "POSITION_FILLED",
      "organization": {
        "id": "5f2b8c91-77d4-4a3e-8b6c-0e1d9a4f2c38",
        "name": "Acme Inc."
      },
      "contract_type": "CONTRACTOR",
      "total_vendors": 3,
      "service_status": "SERVICEABLE",
      "approval_status": "APPROVED",
      "candidate_count": 7,
      "candidate_limit": 10,
      "employment_type": "FULL_TIME",
      "hours_per_month": 160,
      "approval_policy_id": "8a1f0c74-2b16-4f8e-9a0d-5c3e7b219d44",
      "contract_length_type": "FIXED",
      "marked_as_inactive_at": "2026-08-15T09:30:00.000Z",
      "total_hired_candidates": 1,
      "total_vendors_per_status": {
        "approved": 1,
        "hidden_by_hirer": 0,
        "pending_approval": 2,
        "rejected": 0,
        "withdrawn_by_hirer": 0,
        "withdrawn_by_vendor": 0
      },
      "has_non_vendor_candidates": false,
      "ready_to_hire_candidates_count": 1,
      "ready_for_offer_candidates_count": 1,
      "pending_interview_candidates_count": 2,
      "pending_initial_screening_candidates_count": 3
    }
  ],
  "page": {
    "cursor": "eyJwcmV2aW91c1BhZ2VMYXN0SWQiOjEyMzR9",
    "total_rows": 42
  }
}

Returns a cursor-paginated list of Deel Talent job requests for the organization. Use filters to find requests by hiring criteria or approval status, then use the results to populate a dashboard, synchronize an external system, or identify requests needing follow-up. Pass the cursor from each response to retrieve the next page.

Token scopes: talents: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 -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

AuthorizationBearer

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

Query parameters

searchstringOptional<=150 characters

Free-text search over the job request title.

vendor_idslist of stringsOptional

Filter by talent partner identifiers. The reserved value external_provider matches job requests whose candidates were sourced from an external provider rather than a Deel talent partner.

contract_typelist of enumsOptional

Filter by contract type.

Allowed values:

rate_scaleenumOptional

Filter by the rate scale of the job request.

locationslist of stringsOptional

Filter by ISO 3166-1 alpha-2 country codes.

work_modeenumOptional

Filter by work mode.

Allowed values:

statuslist of enumsOptional

Filter by job request status.

Allowed values:

approval_statuslist of enumsOptional

Filter by approval status.

Allowed values:

start_date_fromstringOptionalformat: "date-time"

Only return job requests whose start date is on or after this date.

start_date_tostringOptionalformat: "date-time"

Only return job requests whose start date is on or before this date. Must not be earlier than start_date_from.

end_date_fromstringOptionalformat: "date-time"

Only return job requests whose end date is on or after this date.

end_date_tostringOptionalformat: "date-time"

Only return job requests whose end date is on or before this date. Must not be earlier than end_date_from.

created_at_fromstringOptionalformat: "date-time"

Only return job requests created on or after this date.

created_at_tostringOptionalformat: "date-time"

Only return job requests created on or before this date. Must not be earlier than created_at_from.

request_typeenumOptionalDefaults to GENERAL

Use PENDING_TASKS to return only the job requests awaiting an action from the token owner.

Allowed values:

sort_byenumOptionalDefaults to created_at

Field to sort by.

sort_orderenumOptionalDefaults to ASC

Sort direction.

Allowed values:

cursorstringOptional

Opaque cursor returned by the previous page. Omit to retrieve the first page.

limitintegerOptional1-100Defaults to 10

Maximum number of records to return.

Response

Successful operation.

datalist of objects

The job requests on the requested page.

pageobject

Pagination metadata.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error