Retrieve paginated list of ATS Rejection/Archivation reasons | Deel

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

{
  "data": [
    {
      "id": "a5a03786-0589-440e-93ea-6ecde116bc22",
      "label": "Not interested",
      "created_at": "2025-11-10T15:19:18.389Z",
      "reason_group_slug": "CANDIDATE_ARCHIVATION",
      "jobs_count": 0,
      "updated_at": "2025-11-10T15:19:18.389Z",
      "subgroup_slug": "INTEREST",
      "email_template": {
        "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
        "title": "Not Interested"
      },
      "candidates_count": 0
    }
  ],
  "has_more": false,
  "next_cursor": "string",
  "total_count": 12
}

Retrieves a list of rejection or archivation reasons in the Applicant Tracking System. You can filter reasons by group and subgroup to narrow down the results 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.

1 curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2   -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.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

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