List tags | Deel | Documentation

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

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)

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

Filter tags by label (case-insensitive partial match)

Filter by tag group. Use CANDIDATE for candidate tags.

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

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

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

Successful operation. Returns the list of tags for the organization.

Whether more results exist (pagination).

Cursor for the next page of results, or null if none.

Total number of tags returned.

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/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	}

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

Authentication

Query parameters

Response

Errors

Authentication

Authentication

Query parameters

Response

Errors

Authentication