Skip to navigation
Employer of RecordOffboarding

Offboarding

EOR offboarding is the structured process that ends an EOR employment relationship. Deel enforces a multi-step workflow to ensure compliance with local labor laws, protect both parties, and handle statutory obligations such as notice periods, final pay, and document sign-offs.

There are three distinct offboarding flows, plus a tracker for querying offboarding status across all contracts. Choose the flow that matches who is initiating the offboarding and the type of token you hold.

Choose your flow

Client-initiated termination

The client organization terminates the employment relationship. Uses a client API token.

Client-initiated resignation

The client requests a resignation on behalf of the worker. Uses both client and worker API tokens.

Worker resignation

The worker submits a resignation directly. Uses a worker API token, with a final PTO review from the client.

Offboarding tracker

Query offboarding status across all contracts. Useful for dashboards and HRIS sync.

Prerequisites

  • API access: All requests require a Bearer token in the Authorization header. See Authentication for how to generate one.
  • Token type: Termination uses a client API token. Resignation flows use a combination of client and worker API tokens.
  • Contract ID: Most endpoints require a contract_id. Use the List contracts endpoint to retrieve yours.

Webhooks

Subscribe to these events to track offboarding progress without polling:

EventWhen it fires
contract.terminatedContract reaches final termination
worker.v2.updatedEach offboarding status transition

See the Webhooks guide for setup.

Shared operations

These endpoints apply to both resignation and termination flows.

Retrieve an offboarding attachment

This endpoint requires a client API token.

Offboarding documents such as termination letters and separation agreements are available as attachments. Use the Retrieve offboarding attachment endpoint to download a specific attachment by ID.

curl --location --request GET \
  '{{host}}/rest/eor/contracts/{{contract_id}}/offboarding/attachments/{{attachment_id}}' \
  --header 'Authorization: Bearer {{client_token}}'

The response includes a pre-signed download URL. Download URLs expire after a short period. Always request a fresh URL rather than caching it.

Next steps

Terminations API

Reference for the EOR termination endpoints used in the termination flow.

Webhooks

Subscribe to offboarding events to track status without polling.

Amendments

Manage contract amendments before offboarding begins.

Authentication

Learn how to generate client and worker API tokens.