Skip to main content
GET
/
labels
List Labels
curl --request GET \
  --url https://api.attention.tech/v2/labels \
  --header 'Authorization: <api-key>'
{
  "data": [
    {
      "uuid": "fe515723-fe2e-4959-a5fa-c4d3937fe7e4",
      "name": "Buying Signal",
      "description": "Conversations where the prospect expresses a buying signal.",
      "aiFlow": true,
      "allTeams": false,
      "isDefaultTemplate": false,
      "options": [],
      "organizationUUID": "16b78cec-82ef-46d2-8213-5d3bb7d2571c",
      "createdAt": "2026-04-16T18:00:00Z"
    }
  ],
  "meta": {
    "pageCount": 1,
    "totalRecords": 1,
    "pageNumber": 1,
    "pageSize": 50
  }
}

Authorizations

​
Authorization
string
header
required

Query Parameters

​
page
integer
default:1

1-indexed page number to return. Defaults to 1.

Required range: x >= 1
​
size
integer
default:50

Number of labels per page. Defaults to 50. Maximum 200.

Required range: 1 <= x <= 200

Response

Labels successfully retrieved

Paginated list-response envelope for labels.

​
data
object[]

The page of labels belonging to the caller's organization.

​
meta
object
Example:
{
  "pageCount": 5,
  "totalRecords": 100,
  "pageNumber": 1,
  "pageSize": 20
}