Skip to content

List labels

Request

Retrieves all labels and label groups via REST API

This endpoint supports filtering and pagination through query parameters. Available ransackable attributes: uuid, name, parent_uuid, is_group.

Available ransackable associations and their attributes:

  • parent: parent_uuid, parent_name, parent_parent_uuid, parent_is_group
Query
pagenumber

Page number for pagination (default: 1)

Default:1
per_pagenumber

Number of records per page (default: 20, max: 100)

Default:20
limitnumber

Alias for per_page - number of records per page

Default:20
limit_maxnumber

Maximum number of records per page (overrides limit if not set)

Default:null
offsetnumber

Number of records to skip, for offset/limit clients such as BI connectors. An offset past the end of the collection returns an empty records array, which is the end-of-data signal. To follow data.pagy.next instead of stepping the offset yourself, send it as page while keeping the same offset.

countstring

Set to 'true' to include total count in pagy metadata (data.pagy.count). Use for count/total queries instead of paginating through all pages.

GET
/rest/v2/labels
curl -i -X GET \
  'https://api.rhythms.ai/rest/v2/labels?page=1&per_page=20&limit=20&limit_max=%7Blimit_max%7D&offset=0&count=string'

Responses

Bad Request - Invalid parameters or malformed request