---
title: "List labels"
method: GET
path: "/v1/labels"
tags: ["Labels"]
---

# List labels

`GET /v1/labels`

Retrieve all labels in the organization.

## Response `200`

List of all labels in the organization

- object
  - `labels` Label[]
    - `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

- `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)