> 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. # Retrieve current On-Demand Payroll GET https://api.letsdeel.com/rest/on-demand-payroll/contract/{contract_id}/current Retrieves the active On-Demand Payroll for the given contract, including its status, SLAs, invoice and attached entries. **Token scopes**: `on-demand-payroll:read` Reference: https://developer.deel.com/api/reference/endpoints/on-demand-payroll/retrieve-current-on-demand-payroll-v-2026-07-16 ## 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 ### Path parameters - `contract_id` (string, required) — Public ID (oid) of the contract. ## Response ### 200 The active On-Demand Payroll for the contract. - `data` (OnDemandPayrollContractContractIdCurrentGetResponsesContentApplicationJsonSchemaData, required) — An On-Demand Payroll for a contract. ## Errors ### 400 Bad Request Error Invalid request. - `errors` (list of OnDemandPayrollContractContractIdCurrentGetResponsesContentApplicationJsonSchemaErrorsItems, required) — List of errors. ### 401 Unauthorized Error Authentication is required or has failed. - `errors` (list of OnDemandPayrollContractContractIdCurrentGetResponsesContentApplicationJsonSchemaErrorsItems, required) — List of errors. ### 403 Forbidden Error The caller is not allowed to perform this action. - `errors` (list of OnDemandPayrollContractContractIdCurrentGetResponsesContentApplicationJsonSchemaErrorsItems, required) — List of errors. ### 404 Not Found Error No active On-Demand Payroll for the contract. - `errors` (list of OnDemandPayrollContractContractIdCurrentGetResponsesContentApplicationJsonSchemaErrorsItems, required) — List of errors. ### 500 Internal Server Error Operation failed. - `request` (ApiErrorRequest, optional) - `errors` (list of ApiError, optional) ## Types ### OnDemandPayrollContractContractIdCurrentGetResponsesContentApplicationJsonSchemaData An On-Demand Payroll for a contract. - `id` (string, required) — Public ID of the On-Demand Payroll. - `sla` (OnDemandPayrollContractContractIdCurrentGetResponsesContentApplicationJsonSchemaDataSla, required) — Processing SLAs (in days) configured for the contract EOR entity. - `status` (enum, required) — Lifecycle status of the ODP. - Allowed values: `AWAITING_CLIENT_APPROVAL`, `AWAITING_CLIENT_SUBMISSION`, `AWAITING_ADJUSTMENTS_TO_BE_READY`, `AWAITING_DEEL_PROCESSING`, `DEEL_PROCESSING`, `REJECTED`, `CANCELLED`, `PARTIALLY_APPROVED`, `APPROVED` - `entries` (list of OnDemandPayrollContractContractIdCurrentGetResponsesContentApplicationJsonSchemaDataEntriesItems, required) — Entries currently attached to the ODP. - `invoice_id` (string, optional, nullable) — Public ID of the invoice associated with the ODP, when one has been generated. Use the Invoices API to fetch its details. - `submitted_at` (string, optional, nullable) — Timestamp when the ODP was submitted, when submitted. - `submitted_by` (string, optional, nullable) — Name of the person who submitted the ODP, when submitted. - `deel_reviewed_at` (string, optional, nullable) — Timestamp when Deel reviewed the ODP, when reviewed. - `estimated_payday` (string, optional, nullable) — Estimated payday for the ODP (YYYY-MM-DD). - `next_available_payment_date` (string, optional, nullable) — Next available payment date for the EOR contract (YYYY-MM-DD), when applicable. ### OnDemandPayrollContractContractIdCurrentGetResponsesContentApplicationJsonSchemaErrorsItems - `code` (string, optional) — Machine-readable error code. - `field` (string, optional) — Field that caused the error, when applicable. - `message` (string, optional) — Human-readable error message. ### 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 ### OnDemandPayrollContractContractIdCurrentGetResponsesContentApplicationJsonSchemaDataSla Processing SLAs (in days) configured for the contract EOR entity. - `payment_buffer` (integer, optional, nullable) — Payment buffer in days. - `payment_processing` (integer, optional, nullable) — Payment processing SLA in days. - `payment_settlement` (integer, optional, nullable) — Payment settlement SLA in days. - `payroll_processing` (integer, optional, nullable) — Payroll processing SLA in days. - `post_termination_buffer` (integer, optional, nullable) — Post-termination buffer in days during which an ODP is still allowed. ### OnDemandPayrollContractContractIdCurrentGetResponsesContentApplicationJsonSchemaDataEntriesItems An On-Demand Payroll entry (an adjustment attached to the ODP). - `uom` (enum, required) — Unit of measure of the entry amount. Always CURRENCY. - Allowed values: `CURRENCY` - `type` (string, required) — The adjustment type of the entry. - `title` (string, required) — Short human-readable title of the entry. - `amount` (double, required) — The entry amount in the contract currency. - `currency` (string, required) — ISO 4217 currency code of the entry amount. - `metadata` (OnDemandPayrollContractContractIdCurrentGetResponsesContentApplicationJsonSchemaDataEntriesItemsMetadata, required) — Additional, non-contractual metadata about the entry. - `submitter` (OnDemandPayrollContractContractIdCurrentGetResponsesContentApplicationJsonSchemaDataEntriesItemsSubmitter, optional, nullable) — The person who submitted the entry. - `description` (string, optional, nullable) — Free-text description of the entry. - `date_of_entry` (string, optional, nullable) — Date the entry applies to (YYYY-MM-DD). Null when not available for the entry. ### OnDemandPayrollContractContractIdCurrentGetResponsesContentApplicationJsonSchemaDataEntriesItemsMetadata Additional, non-contractual metadata about the entry. - `type` (string, optional) — The adjustment type of the entry. - `public_id` (string, optional) — Public ID of the underlying adjustment. - `reviewed_at` (string, optional, nullable) — Timestamp of the last review of the entry. - `vendor_name` (string, optional, nullable) — Vendor associated with the entry, when applicable. - `category_label` (string, optional, nullable) — Label of the adjustment category. - `submission_date` (string, optional, nullable) — Timestamp when the entry was submitted. - `category_group_label` (string, optional, nullable) — Label of the adjustment category group. ### OnDemandPayrollContractContractIdCurrentGetResponsesContentApplicationJsonSchemaDataEntriesItemsSubmitter The person who submitted the entry. - `id` (string, optional, nullable) — Public ID of the submitter, when available. - `name` (string, optional) — Full name of the submitter. ## Examples **Response** ```json { "data": { "id": "odp_abc123", "sla": { "payment_buffer": 1, "payment_processing": 2, "payment_settlement": 3, "payroll_processing": 1, "post_termination_buffer": 30 }, "status": "AWAITING_CLIENT_APPROVAL", "entries": [ { "uom": "CURRENCY", "type": "BONUS", "title": "Q1 performance bonus", "amount": 150.5, "currency": "USD", "metadata": { "type": "BONUS", "public_id": "adj_abc123", "reviewed_at": "2026-01-06T10:00:00Z", "vendor_name": "Acme Inc.", "category_label": "Bonus", "submission_date": "2026-01-04T09:00:00Z", "category_group_label": "Compensation" }, "submitter": { "id": "p_abc123", "name": "John Doe" }, "description": "Bonus awarded for Q1 results", "date_of_entry": "2026-01-05" } ], "invoice_id": "inv_abc123", "submitted_at": "2026-01-01T00:00:00Z", "submitted_by": "Jane Doe", "deel_reviewed_at": "2026-01-08T12:00:00Z", "estimated_payday": "2026-01-10", "next_available_payment_date": "2026-01-12" } } ``` **SDK Code** ```python import requests url = "https://api.letsdeel.com/rest/on-demand-payroll/contract/con_abc123/current" headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.letsdeel.com/rest/on-demand-payroll/contract/con_abc123/current'; 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/on-demand-payroll/contract/con_abc123/current" 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/on-demand-payroll/contract/con_abc123/current") 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/on-demand-payroll/contract/con_abc123/current") .header("Authorization", "Bearer ") .asString(); ``` ```php request('GET', 'https://api.letsdeel.com/rest/on-demand-payroll/contract/con_abc123/current', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.letsdeel.com/rest/on-demand-payroll/contract/con_abc123/current"); 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/on-demand-payroll/contract/con_abc123/current")! 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() ```