Retrieve a list of ATS departments | Deel

Returns a paginated list of all departments configured in the organization’s ATS. Use it to resolve the department IDs accepted by the department_ids filter when listing jobs and by job creation, and page through results with the cursor and limit query parameters.

Token scopes: ats:read, worker:read

Returns a paginated list of all departments configured in the organization's ATS. Use it to resolve the department IDs accepted by the `department_ids` filter when listing jobs and by job creation, and page through results with the `cursor` and `limit` query parameters. **Token scopes**: `ats:read`, `worker:read`

Authentication

AuthorizationBearer

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 -X GET 'https://api.deel.training/rest/v2/contracts' \
>   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

## 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.deel.training/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Query parameters

cursorstringOptional

Cursor for pagination to get the next set of results

limitintegerOptional1-100Defaults to 20

Maximum number of records returned in one response

Response

Successful response with departments data

datalist of objects

Page of departments.

has_moreboolean

Indicates if there are more departments available

next_cursorstring or null

Cursor for pagination to get the next set of results; null when there are no more pages

total_countinteger

Total number of departments available

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -G https://api.letsdeel.com/rest/ats/departments \
>	-H "Authorization: Bearer <token>" \
>	-d cursor=cursor123 \
>	-d limit=20

1	{
2	"data": [
3	{
4	"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
5	"name": "Engineering",
6	"created_at": "2023-01-01T00:00:00Z",
7	"updated_at": "2023-01-01T00:00:00Z"
8	}
9	],
10	"has_more": false,
11	"next_cursor": "string",
12	"total_count": 42
13	}

$	curl -X GET 'https://api.deel.training/rest/v2/contracts' \
>	-H 'Authorization: Bearer YOUR-TOKEN-HERE'