---
title: "Get Label"
method: GET
path: "/labels/{id}"
tags: ["Label"]
---

# Get Label

`GET /labels/{id}`

Retrieves a single label by its UUID. The label must belong to the caller's organization; cross-organization lookups return 404 (not 403) to avoid leaking existence of resources in other organizations.

## Path parameters

- `id` string, required

## Response `200`

Label successfully retrieved

- LabelResponse — Single-resource response envelope for label endpoints.
  - `data` Label — 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.
    - `uuid` string, required — Unique identifier of the label.
    - `name` string, required — Human-readable label name. Unique per organization. Trimmed; 1 to 128 characters.
    - `description` string — Longer description of the label's meaning or criteria. 0 to 2000 characters.
    - `aiFlow` boolean, required — Whether this label participates in the AI flow (auto-classification during conversation post-processing).
    - `allTeams` boolean, required — Whether this label applies to all teams in the organization. When false, label visibility is constrained by team assignments managed through the internal API.
    - `isDefaultTemplate` boolean, required — Whether this label originated from the organization's default template. Default-template labels are typically managed as a system-seeded group.
    - `options` LabelOption[] — Optional set of selectable values when the label is a multi-value enum. Empty or omitted for binary labels.
      - `value` string — The option value as displayed to callers. Stored as an arbitrary JSON value server-side; surfaced here as a string for REST ergonomics.
      - `description` string — Optional human-readable description of the option, used for tooltips and AI-flow prompts.
    - `organizationUUID` string, required — UUID of the organization that owns the label. Always matches the authenticated principal's organization on responses.
    - `createdAt` string, date-time, required — Timestamp when the label was created, in ISO 8601 (RFC 3339) format.

## Other responses

- `401` — Authentication failed. Please provide a valid organization-scoped API key.
- `404` — Label not found in the caller's organization
- `500` — Unexpected server error. Please try again later.
- `default` — Unexpected error occurred while retrieving the label

---

[API](https://skmtc.net/attention/apis/attention-service-v2.md) · [All operations](https://skmtc.net/attention/apis/attention-service-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attention/attention-service-v2/versions/5de55d3804cf/schema)