---
title: "Get a label by name"
method: GET
path: "/api/v1/labels/{name}"
tags: ["Labels"]
---

# Get a label by name

`GET /api/v1/labels/{name}`

## Path parameters

- `name` string, required — Label name

## Response `200`

Label details

- LabelsGetResponse
  - `color` string, nullable, required — Hex color for the label (e.g. #0366d6)
  - `description` string, nullable, required — Label description
  - `homepage` boolean, required — Whether label is shown on homepage
  - `name` string, required — Label name
  - `usage_count` number, required — Number of documents with this label
  - `verified` boolean, required — Whether label is verified

## Other responses

- `401` — Authentication required
- `404` — Label not found

---

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