Retrieve paginated list of ATS Rejection/Archivation reasons | Deel

Returns a paginated list of rejection and archivation reasons, filterable by reason_group_slug and subgroup_slug; when include_counts is true, each reason includes a usage count. Token scopes: ats: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 curl -X GET 'https://api.letsdeel.com/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<=1000 characters

The cursor for pagination

limitintegerOptional1-100Defaults to 20

Maximum number of records returned in one response

searchstringOptional<=500 characters

Search text for filtering candidates

reason_group_slugenumOptional

Reason group enum

Allowed values:

include_countsstringOptional

If sent true, it will fetch result with counts

subgroup_slugenumOptional

Reason subgroup enum

Response

Successful operation.

datalist of objects

Array of reason objects

has_moreboolean

Indicates if there are more results available

next_cursorstring or null<=1000 characters

Cursor for pagination to fetch next page

total_countdouble

Total count of reasons

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

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.

1 curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

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

The cursor for pagination

Maximum number of records returned in one response

Search text for filtering candidates

If sent true, it will fetch result with counts

Reason subgroup enum

Successful operation.

Array of reason objects

Indicates if there are more results available

Cursor for pagination to fetch next page

Total count of reasons

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.

1 curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

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

$	curl -G https://api.letsdeel.com/rest/v2/ats/reasons \
>	-H "Authorization: Bearer <token>" \
>	-d cursor=cursorValue \
>	-d limit=50 \
>	--data-urlencode "search=John Doe" \
>	-d reason_group_slug=OFFER_REJECTION \
>	-d include_counts=true \
>	-d subgroup_slug=INTEREST

1	{
2	"data": [
3	{
4	"id": "a5a03786-0589-440e-93ea-6ecde116bc22",
5	"label": "Not interested",
6	"created_at": "2025-11-10T15:19:18.389Z",
7	"reason_group_slug": "CANDIDATE_ARCHIVATION",
8	"jobs_count": 0,
9	"updated_at": "2025-11-10T15:19:18.389Z",
10	"subgroup_slug": "INTEREST",
11	"email_template": {
12	"id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
13	"title": "Not Interested"
14	},
15	"candidates_count": 0
16	}
17	],
18	"has_more": false,
19	"next_cursor": "string",
20	"total_count": 12
21	}

1	curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2	-H 'Authorization: Bearer YOUR-TOKEN-HERE'