List company labels

Returns labels configured for the company account. Results are paginated and can be filtered by name. The system-reserved Deleted label is excluded.

Pagination: Use page and per_page (default 25, max 100). The response includes the headers X-Total-Count (total matching labels) and X-Page-Count (total number of pages) to make page traversal straightforward.

Filtering: Use name for a case-insensitive partial-match filter — handy for companies with thousands of labels.

Query Params
string
required

The API key provided for your application.

string

Case-insensitive partial-match filter on the label name. Must be a string; arrays or other types return 400.

integer
≥ 1
Defaults to 1

Page number (1-based). Defaults to 1.

integer
1 to 100
Defaults to 25

Page size. Defaults to 25, capped at 100.

Responses

401

Missing, invalid, or inactive API key.

500

Internal server error; the response may include an exception message.

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json