> 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://docs.deel.wtf/api/stable/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.deel.wtf/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.deel.wtf/_mcp/server.

## Added

* **Webhooks** → [Send a simulated webhook event](/api/reference/endpoints/webhooks/simulate-webhook-by-id-v-2026-10-28): Endpoint is now available, which allows to send a simulated event payload to a webhook subscription to test it without waiting for a real event.

* **Ats** → [Retrieve ATS email template tokens](/api/reference/endpoints/ats/retrieve-a-list-of-ats-email-template-tokens-v-2026-10-28): Endpoint is now available, which allows to list the placeholder tokens that ATS email templates can contain.

* **Ats** → [Retrieve suggested ATS email templates](/api/reference/endpoints/ats/retrieve-ats-email-template-suggestions-v-2026-10-28): Endpoint is now available, which allows to retrieve suggested ATS email templates for the authenticated user, including frequently used templates and stage-specific suggestions.

* **Ats** → [Retrieve current application counts per interview plan stage](/api/reference/endpoints/ats/retrieve-ats-insights-stage-counts-v-2026-10-28): Endpoint is now available, which allows to retrieve current application counts per interview plan stage.

* **Ats** → [Retrieve average time per interview plan stage](/api/reference/endpoints/ats/retrieve-ats-insights-stage-durations-v-2026-10-28): Endpoint is now available, which allows to retrieve the average time applications spent in each interview plan stage across selected jobs.

* **Ats** → [Retrieve ATS job](/api/reference/endpoints/ats/retrieve-ats-job-v-2026-10-28): Endpoint is now available, which allows to retrieve a single ATS job by its ID, including its current status, closure reason, approval request, and interview plan stages.

* **Ats** → [Generate a preview of an ATS email template](/api/reference/endpoints/ats/retrieve-ats-email-template-preview-v-2026-10-28): Endpoint is now available, which allows to render a published email template for one application, filling its placeholders with the candidate's, job's and sender's data, and report any placeholder that could not be filled.

* **Ats** → [Retrieve ATS offer](/api/reference/endpoints/ats/retrieve-ats-offer-v-2026-10-28): Endpoint is now available, which allows to retrieve a single ATS offer by ID, including its status, approval request, and associated application.

* **Ats** → [Retrieve the ATS activity timeline](/api/reference/endpoints/ats/retrieve-a-list-of-ats-operation-history-logs-v-2026-10-28): Endpoint is now available, which allows to retrieve the history of changes made to candidates, applications, and jobs, including who changed what and when.

* **It Products** → [Retrieve a product's prices for a delivery country](/api/reference/endpoints/it-products/retrieve-it-product-prices-v-2026-10-28): Endpoint is now available, which allows to retrieve a product's prices for a delivery country.

* **People** → [List worker addresses](/api/reference/endpoints/people/get-worker-addresses-v-2026-10-28): Endpoint is now available, which allows to retrieve a worker's current home, postal, and contract addresses, with optional support for future-dated (scheduled) versions.

* **People** → [Update worker address by type](/api/reference/endpoints/people/update-worker-address-by-type-v-2026-10-28): Endpoint is now available, which allows to partially update a worker's home or postal address by type.

* **Talent** → [List job requests](/api/reference/endpoints/talent/list-talent-requisitions-v-2026-10-28): Endpoint is now available, which allows to retrieve a cursor-paginated list of Deel Talent job requests for the organization.

## Changed

* **Payments** → [Retrieve a payment statement](/api/reference/endpoints/payments/get-payment-statement-v-2026-07-23): Added `email`, `network`, `deposit_uri`, and `deposit_address` to `beneficiary_details` in the response; `payment_currency` and `beneficiary_details.currency` now accept `USDC` and `USDT` in addition to three-letter ISO 4217 codes.

* **Payments** → [Create and pay a payment statement](/api/reference/endpoints/payments/create-payment-statement-v-2026-07-23): Added optional `method` and `network` fields to the request `payment` object to support `STABLECOIN_TRANSFER` payments in `USDC` or `USDT`; added `email`, `network`, `deposit_uri`, and `deposit_address` to `beneficiary_details` in the response; `payment_currency` and `beneficiary_details.currency` now accept `USDC` and `USDT` in addition to three-letter ISO 4217 codes.

* **Webhooks** → [List webhooks](/api/reference/endpoints/webhooks/get-webhooks): Added optional `limit`, `cursor`, `status`, `hidden`, `search`, `_order`, and `include` query parameters for pagination and filtering; added `cursor` to the response for next-page navigation; added optional `stats` field to each webhook item in the response with delivery health metrics.

* **Ats Applications** → [Retrieve a list of ATS applications](/api/reference/endpoints/ats-applications/retrieve-a-list-of-ats-applications-v-2026-01-01): Added optional `job_ids`, `hiring_member_hou_ids`, and `hiring_member_role_ids` query parameters to filter applications by a set of job IDs, by HRIS organization users on a job's hiring team, and by those members' roles respectively.

* **Ats Applications** → [Assign application to interview plan stage](/api/reference/endpoints/ats-applications/associate-application-with-an-interview-plan-stage-v-2026-01-01): Added optional `expected_current_interview_plan_stage_id` in the request body that acts as a precondition; if the application's current stage does not match, nothing changes and a 409 is returned.

* **Ats** → [Update ATS Candidate](/api/reference/endpoints/ats/update-ats-candidate-v-2026-09-16): Added `expected_updated_at` in the request that serves as an optimistic-locking precondition: if the candidate has been modified since the value was last read, nothing is updated and a 409 is returned.

* **Ats** → [Update ATS Application](/api/reference/endpoints/ats/update-ats-application-v-2026-09-17): Added `expected_updated_at` in the request body that serves as an optional precondition; if the application has been updated since the supplied timestamp, nothing is changed and a 409 `precondition_failed` is returned.

* **Ats Candidates** → [Set the tags of a candidate](/api/reference/endpoints/ats-candidates/create-candidate-tags-v-2026-02-27): Added optional `expected_tag_ids` in the request body that serves as a precondition; if the candidate's current tags do not match, nothing is replaced and a 409 is returned.

* **Ats Candidates** → [Retrieve paginated list of ATS Candidates](/api/reference/endpoints/ats-candidates/retrieve-paginated-list-of-ats-candidates-v-2026-01-01): Added `city` and `country_code` to the response; added `source_slugs`, `team_ids`, and `locations` as optional query parameters.

* **Ats Hiring Members** → [Retrieve ATS hiring members](/api/reference/endpoints/ats-hiring-members/retrieve-ats-hiring-members): Added `job_id`, `role_id`, and `role_name` to each member in the response; added optional `job_id` query parameter to filter results to a specific job's hiring team.

* **Ats Offers** → [Retrieve a list of ATS offers](/api/reference/endpoints/ats-offers/retrieve-a-list-of-ats-offers-v-2026-01-01): Added `is_required` in the response that indicates whether the custom field is required.

* **Ats Email Templates** → [Retrieve a list of published ATS email templates](/api/reference/endpoints/ats-email-templates/retrieve-a-list-of-published-ats-email-templates-v-2026-02-11): Added `body`, `subject`, and `type` fields to the response; added optional `type` query parameter to filter results by template type.

* **Ats Jobs** → [Retrieve a list of ATS jobs](/api/reference/endpoints/ats-jobs/retrieve-a-list-of-ats-jobs): Added `opened_at`, `closed_at`, and `active_pause_period` to the response; added optional `opened_after`, `opened_before`, `closed_after`, `closed_before`, and `hiring_member_hou_ids` query parameters.

* **Ats** → [List job openings](/api/reference/endpoints/ats/list-openings-v-2026-06-15): Added `filled_at`, `opened_at`, and `recruiter_hris_organization_user_id` to the response; added optional `recruiter_hris_organization_user_ids` and `created_by_hris_organization_user_ids` query parameters.

* **It Assets** → [List IT assets](/api/reference/endpoints/it-assets/list-it-assets-v-2026-01-01): Added `keyboard_layout` and `operating_system` to the response; added optional `keyboard_layouts`, `operating_systems`, and `search` query parameters for filtering by keyboard layout, operating system, and searching by product name or brand.

* **Workers** → [Retrieve one compliance document of a worker contract](/api/reference/endpoints/workers/get-worker-contract-compliance-document-v-2026-08-25): Added `review` in the response that provides the Deel review outcome for the submission, including `status` and `rejection_message`.

* **Eor Hiring** → [Retrieve detailed hiring guide for a country](/api/reference/endpoints/eor-hiring/get-e-o-r-hiring-guide-by-country): Added optional `include_usd_values` query parameter and response fields `salary.min_usd` and `salary.max_usd` that return the salary range converted to USD at the mid-market exchange rate.

* **Workers** → [List compliance documents of a worker contract](/api/reference/endpoints/workers/list-worker-contract-compliance-documents-v-2026-08-25): Added `review` in the response that provides the outcome of the Deel review of the submission.

* **Legal Entities** → [Retrieve the KYB state of a legal entity](/api/reference/endpoints/legal-entities/get-legal-entity-kyb-state-v-2026-10-01): Added `questionnaire` in the response that exposes the applicable industry questionnaire (template, questions, and saved answers). Added `QUESTIONNAIRE` as a valid value for `category` in `requirements` in the response.

* **Legal Entities** → [Upload a KYB document for a legal entity](/api/reference/endpoints/legal-entities/upload-legal-entity-kyb-document-v-2026-10-02): Added `QUESTIONNAIRE_DOCUMENT` as a valid value for `document_type` in the request and response.

* **Legal Entities** → [Submit EDD request answers for a legal entity](/api/reference/endpoints/legal-entities/answer-legal-entity-kyb-edd-v-2026-10-16): Added `questionnaire` to the response containing the industry questionnaire that applies to the legal entity; added `QUESTIONNAIRE` as a valid value for `requirements[].category` in the response.