For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
SupportDeel Home
OverviewPlatformEmployer of RecordContractorsGlobal PayrollHREmbeddedDeel ITAPI ReferenceChangelog
OverviewPlatformEmployer of RecordContractorsGlobal PayrollHREmbeddedDeel ITAPI ReferenceChangelog
  • Resources
    • Blog
    • Community
    • API spec
  • HRIS Guides
    • Introduction
  • HRIS Common Use Cases
    • Sync Deel users to identity providers
  • SCIM API
    • Overview
  • HRIS Endpoints
  • ATS Guides
    • Introduction
    • Getting started
    • Manage jobs
    • Manage candidates and applications
    • Webhooks
  • ATS Common Use Cases
    • From candidate to contract
  • ATS Endpoints
      • GETList tags
LogoLogo
SupportDeel Home
ATS EndpointsAts Tags

List tags

GET
/ats/tags
GET
/rest/v2/ats/tags
$curl -G https://api.letsdeel.com/rest/v2/ats/tags \
>     -H "Authorization: Bearer <token>" \
>     -d search_text=Referral \
>     -d tag_group_slug=CANDIDATE \
>     -d include_counts=false \
>     -d cursor=eyJwYWdlIjoyfQ \
>     -d limit=20
1{
2  "data": [
3    {
4      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
5      "created_at": "2026-02-26T12:00:00.000Z",
6      "updated_at": "2026-02-26T12:00:00.000Z",
7      "label": "Referral",
8      "tag_group_slug": "CANDIDATE",
9      "candidates_count": 5,
10      "created_by_hris_organization_user_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
11      "updated_by_hris_organization_user_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
12    }
13  ],
14  "has_more": false,
15  "next_cursor": "eyJwYWdlIjoyfQ==",
16  "total_count": 10
17}

Returns a paginated list of tags associated with the organization, filterable by label and tag_group_slug; when include_counts is true, each tag includes a count of associated candidates. Token scopes: ats:read

Was this page helpful?
Previous
Built with

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)
OR
AuthorizationBearer
Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Query parameters

search_textstringOptional<=50 characters

Filter tags by label (case-insensitive partial match)

tag_group_slugenumOptional
Filter by tag group. Use CANDIDATE for candidate tags.
Allowed values:
include_countsenumOptionalDefaults to false

When true, each tag includes candidates_count (number of candidates with that tag)

Allowed values:
cursorstringOptional<=1000 characters

Opaque cursor for pagination. Use the value from next_cursor of the previous response to fetch the next page.

limitintegerOptional1-100Defaults to 20

Maximum number of tags to return per page (default: 20, max: 100).

Response

Successful operation. Returns the list of tags for the organization.
datalist of objects
List of tags.
has_moreboolean

Whether more results exist (pagination).

next_cursorstring or null<=1000 characters
Cursor for the next page of results, or null if none.
total_countinteger>=0
Total number of tags returned.

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.

1curl -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/