Receives real-time notifications for specific events across your Deel organization (e.g., contracts, timesheets, payslips, payments).

Submit worker's personal details, contract association, profile type, and company information.

Returns detailed information about a single person in the organization by their public ID. Includes personal details, employment information, and organizational structure.

Creates a people-only record. Suitable for pre-boarding, contingent workers, or scenarios where a contract is not yet applicable.

Supports filtering by search term, teams, custom fields, and other query parameters. Build people directories or sync HR data.

Sets the working location for a worker identified by their HRIS profile ID.

Provisions both a person and an associated employment contract under the organization's own legal entity.

Returns a list of workers currently going through onboarding, including contract details, HRIS profile information, current onboarding status, and onboarding due dates.

Returns detailed onboarding progress, stepper actions, contract info, and HRIS profile info.

Returns detailed onboarding progress, stepper actions, contract info, and HRIS profile info.

Returns a list of contracts currently in the offboarding process. Results can be scoped to custom ranges.

Retrieve complete offboarding and termination details associated with an HRIS profile identifier.

Returns termination details for a contract identified by its unique, base64-encoded offboarding tracker ID.

Returns the right-to-work onboarding case for a worker, including any associated documents.

Retrieves the full record for a specific contract by ID, including status, compensation, worker details, and metadata.

Returns a paginated list of contracts for the organization, with optional filtering.

Returns all contract templates available to the organization, including fixed-rate, pay-as-you-go, and milestone-based types.

Sets an external identifier for a contract. Useful for linking ERP keys or employee numbers.

Whether the contract is paid through Deel (STANDARD) or outside Deel (OFF_PLATFORM).

Returns a secure, time-limited URL for downloading the PDF version of the contract.

Records the worker's signature on the contract. Only unsigned, pending contracts can be signed.

Rejects a contract provided it is currently in a pending, unsigned state.

Records the worker's signature on a pending amendment.

Returns configuration for available countries. If no configuration exists, all are treated as enabled.

Initiates termination of an active contract, recording the termination reason, effective date, and final payment details.

Cancels a pending termination request for the specified contract, reverting it to its pre-termination state.

Retrieves the standardized list of termination reasons to present when initiating a contract termination.

Employee acknowledges their EOR assignment agreement as part of project initiation.

Kicks off generation of an employee agreement template PDF draft.

Cancels the EOR contract identified by its OID. Must be in active or pending state.

Defers the scheduled onboarding start date for the EOR employee.

Retrieves the versioned form definition for creating an EOR contract in the specified country.

Returns earliest allowed start date based on visa requirements and location.

Returns allowances and non-statutory additional costs available for the contract quote.

Returns benefits available in a specific country, scoped by work visa, hours, and entity.

Returns salary requirements, holidays, probation terms, health insurance, and currency information.

Applies a signature and job title to a specified EOR contract document (e.g. FRAMEWORK_AGREEMENT).

Updates employee information on an EOR contract. Only permitted in pre-active states.

Returns benefits associated with the specified EOR contract, including plan details and status.

Retrieves country-specific fields required for GP workers to ensure local regulatory compliance.

Update employment type (full-time, part-time, or on leave) and FTE for Global Payroll contracts.

Returns a pre-signed, temporary download URL for a specific Global Payroll employee payslip PDF.

Returns payslip history, including date range and status, restricted to GP contract types.

Returns a signed, time-limited HTTPS URL to download the invoice PDF for embedded worker flows.

Retrieves detailed invoice information by its public ID for reference or verification purposes.

Submit a new tax form (W9_INDIVIDUAL, W9_COMPANY, W8_BEN, W8_BEN_E) for the authenticated worker.

Returns a paginated list of all tax forms owned by the authenticated worker, ordered descending.

Retrieves a payment statement including status, amounts, beneficiary details, and settled invoices.

Creates payment statement for invoices, attaches a bank transfer method, applies balance, and pays.

Creates an invoice adjustment (bonus, commission, VAT, deduction) against a contract.

Permanently removes an invoice adjustment by its ID.

Retrieves detailed information about a single invoice line item adjustment by ID.

Returns invoice adjustments with optional filtering by contract, type, status, or date.

Retrieves invoice line items (adjustments) associated with a given contract_id.

Submits an approve or decline review decision for a single invoice adjustment.

Applies a partial update to an existing invoice adjustment based on the request payload.

Returns a paginated list of invoices; filters by status are supported.

Use this endpoint to retrieve a list of refund statements for reconciliation.

Returns a paginated list of invoices specifically for Deel platform fees.

Returns a temporary, time-limited download URL for an invoice PDF.

Returns a breakdown of a payment made to Deel, listing individual invoices and platform fees.

Returns a cursor-paginated list of payments to Deel, including worker details and payment status.

Returns time-off entitlements for the specified hris_profile_id, including balances.

Applies a partial update to an existing time-off request without requiring cancellation.

Cancels the time-off request identified by time_off_id, immediately setting status to CANCELED.

Returns policy validation templates and policy types for one or more countries.

Returns holidays, work schedules, and time-off dailies for a given date range.

Creates a new time-off request with detailed date breakdowns.

Returns a paginated list of time-off requests for the specified hris_profile_id.

Validates a time-off request against policy compliance, available balance, and blackout dates.

Approves or rejects a batch of time-off requests in a single call.

Upserts or deletes time-off requests for Global Payroll contracts based on external IDs.

Returns time-off events for a worker profile identified by hris_profile_id.

Returns time-off policies assigned to the specified hris_profile_id, including accruals.

Returns time-off requests for the authenticated organization with optional filtering.

Returns a short-lived presigned URL to download a time-off attachment from storage.

Updates a timesheet entry. Only fields provided in the payload will be modified.

Retrieves the details of a single timesheet entry by its unique identifier.

Submits an approve or decline review decision for a timesheet.

Creates a timesheet entry recording the contract, date, hours worked, and an optional description.

Returns a paginated list of timesheets in the account, with optional filtering parameters.

Retrieves timesheets associated with a given contract_id, with optional filtering.

Creates a new job in the ATS. Use after plan, team, and location have been determined.

Returns a paginated list of ATS jobs. Filter postings by search text, location, or status.

Add a candidate to the ATS with required information and optional details.

Replaces all existing tags on a candidate with the provided set of tag IDs.

Returns a paginated list of candidates, optionally filtered by jobs or tags.

Adds a note to a specific application. The author_id must correspond to a valid HRIS user.

Associates an application with an interview plan stage, advancing or updating history.

Creates a new ATS application linking an existing candidate to an existing job.

Returns a cursor-paginated list of candidate applications across all open positions.

Retrieves a single ATS application by its application_id, including metadata.

Retrieves the details of an immigration case by its case ID from the client perspective.

Retrieves the details of an immigration case document by its document ID.

Returns available business visa options along with fees, timelines, and criteria.

Retrieves a paginated list of immigration cases with filters for name, status, and country.

Returns the visa types supported for immigration processing in a specific country.

Returns a paginated list of immigration cases, optionally filtered by applicant name or country.

Uploads a document against a specific case document requirement and submits it for review.

Retrieves the details of a specific document requirement within a worker's immigration case.

Get detailed information for a specific immigration case (worker context).

Creates a new immigration case for a worker. Appropriate visa type must be determined beforehand.

Retrieves the externally-visible notes for an immigration case, most recent first.

Creates a new legal entity under the organization and returns the entity record.

Archives the legal entity identified by ID, marking it as inactive.

Applies a partial update to an existing legal entity identified by ID.

Lists industry subcategories with parent details and NAICS codes.

Returns a paginated list of legal entities in the account with optional filtering.

Controls whether employees under this entity can access the Deel employee app.

Returns details of the organization associated with the authentication token.

Creates a child organization linked to the parent, provisioning a token and user.

Applies a partial update to the custom role, modifying only the fields supplied.

Returns the list of departments within the organization, including identifiers.

Issues a short-lived session token (valid 6 hours) for a child organization.

Returns the list of teams within the authenticated user's organization.

Retrieves all roles defined within the current organization.

Creates a new custom role within the current organization.

Updates the employer approval status for a pending equity exercise.

Associates the specified option grant and stakeholder details with a worker in a pending state.