> This page is for API, version 2026-01-01 (Stable) (default). > For other versions, use one of these documentation indexes: > - 2026-01-01 (Stable) (default): https://developer.deel.com/api/stable/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developer.deel.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.deel.com/_mcp/server. # List job requests GET https://api.letsdeel.com/rest/vms/requisitions 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` Reference: https://developer.deel.com/api/reference/endpoints/talent/list-requisitions-v-2026-09-10 ## Authentication - `Authorization` header (bearer token, required) — ## 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) - `Authorization` header (bearer token, required) — Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/ ## Servers - `https://api.letsdeel.com/rest` (Production, default) - `https://api-staging.letsdeel.com/rest` (Demo) ## Request ### Query parameters - `search` (string, optional) — Free-text search over the job request title. - `vendor_ids` (list of string, optional) — 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_type` (list of enum, optional) — Filter by contract type. - Allowed values: `EMPLOYEE`, `CONTRACTOR` - `rate_scale` (enum, optional) — Filter by the rate scale of the job request. - Allowed values: `HOURLY`, `MILESTONE`, `DAILY`, `WEEKLY`, `MONTHLY`, `ANNUAL` - `locations` (list of string, optional) — Filter by ISO 3166-1 alpha-2 country codes. - `work_mode` (enum, optional) — Filter by work mode. - Allowed values: `REMOTE`, `OFFICE`, `HYBRID` - `status` (list of enum, optional) — Filter by job request status. - Allowed values: `ACTIVE`, `PAUSED`, `CLOSED`, `NOT_SHARED` - `approval_status` (list of enum, optional) — Filter by approval status. - Allowed values: `NOT_REQUESTED`, `REQUESTED`, `APPROVED`, `REJECTED`, `CANCELLED` - `start_date_from` (string, optional) — Only return job requests whose start date is on or after this date. - `start_date_to` (string, optional) — Only return job requests whose start date is on or before this date. Must not be earlier than `start_date_from`. - `end_date_from` (string, optional) — Only return job requests whose end date is on or after this date. - `end_date_to` (string, optional) — Only return job requests whose end date is on or before this date. Must not be earlier than `end_date_from`. - `created_at_from` (string, optional) — Only return job requests created on or after this date. - `created_at_to` (string, optional) — Only return job requests created on or before this date. Must not be earlier than `created_at_from`. - `request_type` (enum, optional, default: GENERAL) — Use `PENDING_TASKS` to return only the job requests awaiting an action from the token owner. - Allowed values: `GENERAL`, `PENDING_TASKS` - `sort_by` (enum, optional, default: created_at) — Field to sort by. - Allowed values: `n_candidates`, `n_positions`, `rate_min`, `rate_max`, `created_at`, `start_date`, `end_date`, `status` - `sort_order` (enum, optional, default: ASC) — Sort direction. - Allowed values: `ASC`, `DESC` - `cursor` (string, optional) — Opaque cursor returned by the previous page. Omit to retrieve the first page. - `limit` (integer, optional, default: 10) — Maximum number of records to return. ## Response ### 200 Successful operation. - `data` (list of VmsRequisitionsGetResponsesContentApplicationJsonSchemaDataItems, required) — The job requests on the requested page. - `page` (VmsRequisitionsGetResponsesContentApplicationJsonSchemaPage, required) — Pagination metadata. ## Errors ### 400 Bad Request Error Invalid request parameters. - `errors` (list of VmsRequisitionsGetResponsesContentApplicationJsonSchemaErrorsItems, optional) — Validation errors that describe why the request was rejected. ### 401 Unauthorized Error Unauthorized. - `errors` (list of VmsRequisitionsGetResponsesContentApplicationJsonSchemaErrorsItems, optional) — Errors that describe why the request was not authenticated. ### 403 Forbidden Error Forbidden. - `errors` (list of VmsRequisitionsGetResponsesContentApplicationJsonSchemaErrorsItems, optional) — Errors that describe why the request was not permitted. ### 404 Not Found Error Operation failed. - `request` (ApiErrorRequest, optional) - `errors` (list of ApiError, optional) ### 500 Internal Server Error Internal server error. - `errors` (list of VmsRequisitionsGetResponsesContentApplicationJsonSchemaErrorsItems, optional) — Errors that describe the unexpected server failure. ## Types ### VmsRequisitionsGetResponsesContentApplicationJsonSchemaDataItems - `id` (string, optional, nullable) — Unique identifier of the job request. - `title` (string, optional) — Job request title. - `status` (enum, optional) — Job request status. - Allowed values: `ACTIVE`, `PAUSED`, `CLOSED`, `NOT_SHARED` - `vendors` (list of VmsRequisitionsGetResponsesContentApplicationJsonSchemaDataItemsVendorsItems, optional) — Talent partners attached to the job request. - `yoe_min` (integer, optional, nullable) — Minimum years of experience required. - `currency` (string, optional, nullable) — ISO 4217 currency code of the rate. - `end_date` (string, optional, nullable) — Requested end date. - `quantity` (integer, optional) — Number of open positions. - `rate_max` (double, optional, nullable) — Upper bound of the rate range. - `rate_min` (double, optional, nullable) — Lower bound of the rate range. - `locations` (list of string, optional, nullable) — ISO 3166-1 alpha-2 country codes the job request targets. - `work_mode` (enum, optional, nullable) — Work mode. - Allowed values: `REMOTE`, `OFFICE`, `HYBRID` - `close_note` (string, optional, nullable) — Free-text note recorded when closing the job request. - `created_at` (string, optional) — When the job request was created. - `job_family` (string, optional, nullable) — Job family. - `rate_scale` (enum, optional, nullable) — Scale the rate range is expressed in. - Allowed values: `HOURLY`, `MILESTONE`, `DAILY`, `WEEKLY`, `MONTHLY`, `ANNUAL` - `start_date` (string, optional, nullable) — Requested start date. - `updated_at` (string, optional) — When the job request was last updated. - `description` (string, optional, nullable) — Job request description. - `close_reason` (string, optional, nullable) — Reason the job request was closed. - `organization` (VmsRequisitionsGetResponsesContentApplicationJsonSchemaDataItemsOrganization, optional) — Organization the job request belongs to. - `contract_type` (enum, optional, nullable) — Contract type of the job request. - Allowed values: `EMPLOYEE`, `CONTRACTOR` - `total_vendors` (integer, optional) — Number of talent partners attached to the job request. - `service_status` (enum, optional, nullable) — Whether Deel can service the job request. - Allowed values: `PENDING`, `SERVICEABLE`, `NOT_SERVICEABLE` - `approval_status` (enum, optional) — Approval status of the job request. - Allowed values: `NOT_REQUESTED`, `REQUESTED`, `APPROVED`, `REJECTED`, `CANCELLED` - `candidate_count` (integer, optional) — Total number of candidates on the job request. - `candidate_limit` (integer, optional, nullable) — Maximum number of candidates each talent partner may submit. - `employment_type` (enum, optional, nullable) — Employment type. - Allowed values: `FULL_TIME`, `PART_TIME` - `hours_per_month` (integer, optional, nullable) — Expected hours per month. - `approval_policy_id` (string, optional, nullable) — Identifier of the approval policy applied to the job request. - `contract_length_type` (enum, optional, nullable) — Whether the engagement is fixed-term or indefinite. - Allowed values: `FIXED`, `INDEFINITE` - `marked_as_inactive_at` (string, optional, nullable) — When the job request was flagged as inactive, if it was. - `total_hired_candidates` (integer, optional) — Number of candidates hired on this job request. - `total_vendors_per_status` (map from string to integer, optional) — Count of attached talent partners per status. - `has_non_vendor_candidates` (boolean, optional) — Whether the job request has candidates not sourced through a talent partner. - `ready_to_hire_candidates_count` (integer, optional) — Candidates who accepted an offer and are ready to be hired. Returned as `0` when the token owner is only an approver on the job request. - `ready_for_offer_candidates_count` (integer, optional) — Candidates ready to receive an offer. Returned as `0` when the token owner is only an approver on the job request. - `pending_interview_candidates_count` (integer, optional) — Candidates awaiting an interview. Returned as `0` when the token owner is only an approver on the job request. - `pending_initial_screening_candidates_count` (integer, optional) — Candidates awaiting initial screening. Returned as `0` when the token owner is only an approver on the job request. ### VmsRequisitionsGetResponsesContentApplicationJsonSchemaPage Pagination metadata. - `cursor` (string, required) — Cursor to pass to the next request. Empty when no records remain. - `total_rows` (integer, required) — Total number of job requests matching the filters. ### VmsRequisitionsGetResponsesContentApplicationJsonSchemaErrorsItems - `code` (string, optional) — Machine-readable error code - `message` (string, optional) — Human-readable explanation ### ApiErrorRequest - `method` (string, optional) — The HTTP method of the failed request - `url` (string, optional) — The relative URL of the failed request - `status` (double, optional) — The status code of the response - `api_req_id` (string, optional) — The request ID of the failed request - `docs` (string, optional) — A link to the official documentation for the requested endpoint resource - `source` (string, optional) — The source handler which produced the returned error - `code` (double, optional) — The code of the source handler which produced the returned error ### ApiError - `message` (string, optional) — A description of the returned error - `path` (string, optional) — The JSON path where input validation failed ### VmsRequisitionsGetResponsesContentApplicationJsonSchemaDataItemsVendorsItems - `id` (string, optional, nullable) — Unique identifier of the talent partner. - `name` (string, optional) — Name of the talent partner. - `status` (enum, optional) — Status of the talent partner on this job request. - Allowed values: `APPROVED`, `REJECTED`, `PENDING_APPROVAL`, `HIDDEN_BY_HIRER`, `WITHDRAWN_BY_HIRER`, `WITHDRAWN_BY_VENDOR` - `fee_type` (enum, optional) — Agreed fee type. - Allowed values: `ONE_TIME_FIXED`, `ONE_TIME_PERCENTAGE`, `RECURRING_FIXED`, `RECURRING_PERCENTAGE`, `DEPRECATED` - `logo_url` (string, optional, nullable) — Talent partner logo URL. - `fee_value` (double, optional) — Agreed fee value. - `created_at` (string, optional) — When the talent partner was attached. - `updated_at` (string, optional) — When the attachment was last updated. - `rejected_reason` (string, optional, nullable) — Reason the talent partner rejected the job request. - `status_updated_at` (string, optional) — When the status last changed. - `work_order_status` (enum, optional) — Status of the associated work order. - Allowed values: `NOT_REQUIRED`, `AWAITING_CREATION`, `PENDING_VENDOR_SIGNATURE`, `REJECTED_BY_VENDOR`, `REJECTED_DUE_TO_INACTIVITY`, `REJECTED_BY_HIRER`, `SIGNED` - `hirer_withdrawn_reason` (string, optional, nullable) — Reason the client withdrew the talent partner. - `vendor_withdrawn_reason` (string, optional, nullable) — Reason the talent partner withdrew. - `work_order_status_updated_at` (string, optional, nullable) — When the work order status last changed. ### VmsRequisitionsGetResponsesContentApplicationJsonSchemaDataItemsOrganization Organization the job request belongs to. - `id` (string, optional, nullable) — Unique identifier of the organization. - `name` (string, optional, nullable) — Organization name. ## Examples **Response** ```json { "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 } } ``` **SDK Code** ```python import requests url = "https://api.letsdeel.com/rest/vms/requisitions" querystring = {"approval_status":"[\"APPROVED\"]","contract_type":"[\"CONTRACTOR\"]","created_at_from":"2026-01-01T00:00:00.000Z","created_at_to":"2026-06-30T00:00:00.000Z","cursor":"eyJwcmV2aW91c1BhZ2VMYXN0SWQiOjEyMzR9","end_date_from":"2026-09-01T00:00:00.000Z","end_date_to":"2026-12-31T00:00:00.000Z","limit":"10","locations":"[\"US\"]","rate_scale":"MONTHLY","request_type":"GENERAL","search":"engineer","sort_by":"created_at","sort_order":"ASC","start_date_from":"2026-09-01T00:00:00.000Z","start_date_to":"2026-12-31T00:00:00.000Z","status":"[\"ACTIVE\"]","vendor_ids":"[\"3cfbb359-6084-46c0-9d3f-1ed1a1007a7a\"]","work_mode":"REMOTE"} headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers, params=querystring) print(response.json()) ``` ```javascript const url = 'https://api.letsdeel.com/rest/vms/requisitions?approval_status=%5B%22APPROVED%22%5D&contract_type=%5B%22CONTRACTOR%22%5D&created_at_from=2026-01-01T00%3A00%3A00.000Z&created_at_to=2026-06-30T00%3A00%3A00.000Z&cursor=eyJwcmV2aW91c1BhZ2VMYXN0SWQiOjEyMzR9&end_date_from=2026-09-01T00%3A00%3A00.000Z&end_date_to=2026-12-31T00%3A00%3A00.000Z&limit=10&locations=%5B%22US%22%5D&rate_scale=MONTHLY&request_type=GENERAL&search=engineer&sort_by=created_at&sort_order=ASC&start_date_from=2026-09-01T00%3A00%3A00.000Z&start_date_to=2026-12-31T00%3A00%3A00.000Z&status=%5B%22ACTIVE%22%5D&vendor_ids=%5B%223cfbb359-6084-46c0-9d3f-1ed1a1007a7a%22%5D&work_mode=REMOTE'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.letsdeel.com/rest/vms/requisitions?approval_status=%5B%22APPROVED%22%5D&contract_type=%5B%22CONTRACTOR%22%5D&created_at_from=2026-01-01T00%3A00%3A00.000Z&created_at_to=2026-06-30T00%3A00%3A00.000Z&cursor=eyJwcmV2aW91c1BhZ2VMYXN0SWQiOjEyMzR9&end_date_from=2026-09-01T00%3A00%3A00.000Z&end_date_to=2026-12-31T00%3A00%3A00.000Z&limit=10&locations=%5B%22US%22%5D&rate_scale=MONTHLY&request_type=GENERAL&search=engineer&sort_by=created_at&sort_order=ASC&start_date_from=2026-09-01T00%3A00%3A00.000Z&start_date_to=2026-12-31T00%3A00%3A00.000Z&status=%5B%22ACTIVE%22%5D&vendor_ids=%5B%223cfbb359-6084-46c0-9d3f-1ed1a1007a7a%22%5D&work_mode=REMOTE" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.letsdeel.com/rest/vms/requisitions?approval_status=%5B%22APPROVED%22%5D&contract_type=%5B%22CONTRACTOR%22%5D&created_at_from=2026-01-01T00%3A00%3A00.000Z&created_at_to=2026-06-30T00%3A00%3A00.000Z&cursor=eyJwcmV2aW91c1BhZ2VMYXN0SWQiOjEyMzR9&end_date_from=2026-09-01T00%3A00%3A00.000Z&end_date_to=2026-12-31T00%3A00%3A00.000Z&limit=10&locations=%5B%22US%22%5D&rate_scale=MONTHLY&request_type=GENERAL&search=engineer&sort_by=created_at&sort_order=ASC&start_date_from=2026-09-01T00%3A00%3A00.000Z&start_date_to=2026-12-31T00%3A00%3A00.000Z&status=%5B%22ACTIVE%22%5D&vendor_ids=%5B%223cfbb359-6084-46c0-9d3f-1ed1a1007a7a%22%5D&work_mode=REMOTE") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.letsdeel.com/rest/vms/requisitions?approval_status=%5B%22APPROVED%22%5D&contract_type=%5B%22CONTRACTOR%22%5D&created_at_from=2026-01-01T00%3A00%3A00.000Z&created_at_to=2026-06-30T00%3A00%3A00.000Z&cursor=eyJwcmV2aW91c1BhZ2VMYXN0SWQiOjEyMzR9&end_date_from=2026-09-01T00%3A00%3A00.000Z&end_date_to=2026-12-31T00%3A00%3A00.000Z&limit=10&locations=%5B%22US%22%5D&rate_scale=MONTHLY&request_type=GENERAL&search=engineer&sort_by=created_at&sort_order=ASC&start_date_from=2026-09-01T00%3A00%3A00.000Z&start_date_to=2026-12-31T00%3A00%3A00.000Z&status=%5B%22ACTIVE%22%5D&vendor_ids=%5B%223cfbb359-6084-46c0-9d3f-1ed1a1007a7a%22%5D&work_mode=REMOTE") .header("Authorization", "Bearer ") .asString(); ``` ```php request('GET', 'https://api.letsdeel.com/rest/vms/requisitions?approval_status=%5B%22APPROVED%22%5D&contract_type=%5B%22CONTRACTOR%22%5D&created_at_from=2026-01-01T00%3A00%3A00.000Z&created_at_to=2026-06-30T00%3A00%3A00.000Z&cursor=eyJwcmV2aW91c1BhZ2VMYXN0SWQiOjEyMzR9&end_date_from=2026-09-01T00%3A00%3A00.000Z&end_date_to=2026-12-31T00%3A00%3A00.000Z&limit=10&locations=%5B%22US%22%5D&rate_scale=MONTHLY&request_type=GENERAL&search=engineer&sort_by=created_at&sort_order=ASC&start_date_from=2026-09-01T00%3A00%3A00.000Z&start_date_to=2026-12-31T00%3A00%3A00.000Z&status=%5B%22ACTIVE%22%5D&vendor_ids=%5B%223cfbb359-6084-46c0-9d3f-1ed1a1007a7a%22%5D&work_mode=REMOTE', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.letsdeel.com/rest/vms/requisitions?approval_status=%5B%22APPROVED%22%5D&contract_type=%5B%22CONTRACTOR%22%5D&created_at_from=2026-01-01T00%3A00%3A00.000Z&created_at_to=2026-06-30T00%3A00%3A00.000Z&cursor=eyJwcmV2aW91c1BhZ2VMYXN0SWQiOjEyMzR9&end_date_from=2026-09-01T00%3A00%3A00.000Z&end_date_to=2026-12-31T00%3A00%3A00.000Z&limit=10&locations=%5B%22US%22%5D&rate_scale=MONTHLY&request_type=GENERAL&search=engineer&sort_by=created_at&sort_order=ASC&start_date_from=2026-09-01T00%3A00%3A00.000Z&start_date_to=2026-12-31T00%3A00%3A00.000Z&status=%5B%22ACTIVE%22%5D&vendor_ids=%5B%223cfbb359-6084-46c0-9d3f-1ed1a1007a7a%22%5D&work_mode=REMOTE"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://api.letsdeel.com/rest/vms/requisitions?approval_status=%5B%22APPROVED%22%5D&contract_type=%5B%22CONTRACTOR%22%5D&created_at_from=2026-01-01T00%3A00%3A00.000Z&created_at_to=2026-06-30T00%3A00%3A00.000Z&cursor=eyJwcmV2aW91c1BhZ2VMYXN0SWQiOjEyMzR9&end_date_from=2026-09-01T00%3A00%3A00.000Z&end_date_to=2026-12-31T00%3A00%3A00.000Z&limit=10&locations=%5B%22US%22%5D&rate_scale=MONTHLY&request_type=GENERAL&search=engineer&sort_by=created_at&sort_order=ASC&start_date_from=2026-09-01T00%3A00%3A00.000Z&start_date_to=2026-12-31T00%3A00%3A00.000Z&status=%5B%22ACTIVE%22%5D&vendor_ids=%5B%223cfbb359-6084-46c0-9d3f-1ed1a1007a7a%22%5D&work_mode=REMOTE")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```