> 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.

# Offboarding tracker

> Query offboarding status across all contracts. Useful for dashboards, HRIS sync, and bulk operations.

The offboarding tracker endpoints let you query offboarding status across all your workers without a specific contract ID. Use these to build dashboards, sync offboarding state into external HR systems, or look up a termination record when you only have an HRIS profile identifier.

For an overview of all offboarding flows, see [EOR offboarding](/api/employer-of-record/eor-offboarding).

## Prerequisites

* **Client API token**: All tracker endpoints require a client API token. See [Authentication](/api/authentication).
* **OAuth scopes**: All tracker endpoints require the `contracts:read` and `people:read` scopes.

## List offboarding records

Use the [Retrieve offboarding list](/api/reference/endpoints/offboarding/retrieve-offboarding-list) endpoint to retrieve a paginated list of offboarding records across all contracts. Each record includes the contract, current progress status, hiring type, and a `termination_id` when applicable.

```shell
curl --location --request GET \
  '{{host}}/rest/offboarding/tracker?limit=20&hiring_types=employee&progress_statuses=ACTIVE' \
  --header 'Authorization: Bearer {{client_token}}'
```

| Parameter           | Type    | Description                                           |
| ------------------- | ------- | ----------------------------------------------------- |
| `search`            | string  | Filter by contract name or attributes                 |
| `hiring_types`      | array   | `contractor` or `employee`                            |
| `progress_statuses` | array   | `ACTIVE`, `INACTIVE`, or `ONBOARDING`                 |
| `limit`             | integer | Results per page (default: 20)                        |
| `sort_by`           | string  | Field to sort by (default: `progressStatusWeight`)    |
| `sort_order`        | string  | `ASC` or `DESC` (default: `ASC`)                      |
| `include_overview`  | boolean | Include summary overview in response (default: false) |

The response contains a `data` array of offboarding records and a `page` object with `cursor` and `total_rows` for pagination. Each record includes `termination_id`: use this as the `{id}` path parameter in the next two endpoints.

## Retrieve termination details

Use the [Retrieve termination details](/api/reference/endpoints/offboarding/retrieve-termination-details) endpoint to get full details for a specific offboarding record by its tracker ID. The `id` is the `termination_id` value returned in the list response.

```shell
curl --location --request GET \
  '{{host}}/rest/offboarding/tracker/{{tracker_id}}' \
  --header 'Authorization: Bearer {{client_token}}'
```

The response includes the contract details, current progress status, termination information (end date, type, and rehire eligibility), and HRIS profile data.

## Retrieve termination details by HRIS profile

Use the [Retrieve termination details by HRIS profile identifier](/api/reference/endpoints/offboarding/retrieve-termination-details-by-hris-profile-identifier) endpoint to look up a termination record using the worker's HRIS profile OID instead of a tracker ID. This is useful when integrating with HRIS systems where the OID is the primary identifier.

```shell
curl --location --request GET \
  '{{host}}/rest/offboarding/tracker/hris_profile/{{hris_oid}}' \
  --header 'Authorization: Bearer {{client_token}}'
```

The `hris_oid` is available as `hris_profile.oid` in the list response or from your HRIS sync. The response shape is identical to the tracker ID lookup, including contract, progress, termination, and HRIS profile fields.

## Next steps

#### [Offboarding overview](/api/employer-of-record/eor-offboarding)

Return to the offboarding overview and individual flows.

#### [Client-initiated termination](/api/employer-of-record/eor-offboarding/client-termination)

The flow that produces the termination records exposed by the tracker.

#### [Webhooks](/api/webhooks/quickstart)

Subscribe to offboarding events instead of polling the tracker.

#### [Authentication](/api/authentication)

Learn how to generate API tokens and configure OAuth scopes.