Skip to main content
GET
/
labels
/
{id}
Get Label
curl --request GET \
  --url https://api.attention.tech/v2/labels/{id} \
  --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"
  }
}

Authorizations

​
Authorization
string
header
required

Path Parameters

​
id
string
required

UUID of the label to retrieve.

Response

Label successfully retrieved

Single-resource response envelope for label endpoints.

​
data
object

A label (label category) used to classify conversations and drive AI flows, scorecard criteria, and intelligence-item-collection criteria. Labels are scoped to a single organization.

Example:
{
  "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": [
    {
      "value": "high-intent",
      "description": "Prospect has explicit buying signals"
    }
  ],
  "organizationUUID": "16b78cec-82ef-46d2-8213-5d3bb7d2571c",
  "createdAt": "2026-04-16T18:00:00Z"
}