EndpointsAts

List tags

Use this endpoint to list all tags associated with the organization. View or organize tags based on filters like label or tag group. 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)
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