---
title: "List labels"
description: "Labels in the workspace and how many mentions carry each, the most used first.\n\nA label exists while a mention carries it. Filter mentions with `labels` / `notLabels`."
canonical: https://docs.mentio.dev/api/automations/list-labels
markdown: https://docs.mentio.dev/api/automations/list-labels.mdx
---

# List labels

`GET /v1/labels`

Labels in the workspace and how many mentions carry each, the most used first.

A label exists while a mention carries it. Filter mentions with `labels` / `notLabels`.

## Parameters

- `limit` (query): Page size, 1 to 100.
- `offset` (query): Skip this many labels.

## Responses

- 200: Labels
- 400: Invalid limit or offset (validation_error)
- 401: Missing or invalid API key

Full schemas: https://api.mentio.dev/v1/openapi.json. Conventions: https://docs.mentio.dev/conventions.mdx