---
title: "Get label"
method: GET
path: "/v1/labels/{labelName}"
tags: ["Labels"]
---

# Get label

`GET /v1/labels/{labelName}`

Retrieve a single label by name.

## Path parameters

- `labelName` string, required

## Response `200`

Label details

- Label — A label for organizing and categorizing documents and folders
  - `name` string — The label name (2-25 characters). Names are case-insensitive: `"Production"` and `"production"` are considered the same.
  - `verified` boolean — Whether the label is verified/curated
  - `homepage` boolean — Whether the label appears on the organization homepage
  - `usage_count` integer — Total number of documents and folders using this label
  - `color` string — Hex color for the label
  - `description` string — Description of the label

## Other responses

- `404` — Label not found
- `429` — Too Many Requests - Rate limit exceeded (60 requests/minute)

---

[API](https://skmtc.net/omni/apis/omni-api.md) · [All operations](https://skmtc.net/omni/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omni/omni-api/revisions/6b02f7349d0e/schema)