---
title: "List labels in use"
method: GET
path: "/v1/messages/labels"
tags: ["Messages"]
---

# List labels in use

`GET /v1/messages/labels`

## Request

- Base URL: `https://anjal.app`
- URL: `https://anjal.app/v1/messages/labels`
- Auth: API key in header `X-API-Key`

Every label in use, with how many threads carry it. Same scoping as `GET /v1/messages`.

## Query parameters

- `inboxId` string, uuid

## Response `200`

OK

- object
  - `labels` object[]
    - `label` string
    - `threads` integer

---

[API](https://skmtc.dev/anjal/apis/anjal-api.md) · [All operations](https://skmtc.dev/anjal/apis/anjal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/anjal/apis/anjal-api/revisions/a4044778e294?raw)