> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tuco.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Lead Tags

> Every tag in use on your Tuco leads, with how many leads carry each one.

Returns the tags on your workspace's leads with a lead count for each, listed alphabetically.
Tags that differ only in letter case are one entry (`VIP` and `vip`), shown with the most-used
spelling. If you have more than 500 tags, the 500 most-used are returned.

To list the leads carrying a tag, call [`GET /api/leads?tag=<tag>`](https://docs.tuco.ai/api-reference/endpoint/get).
That match is case-insensitive and on the whole tag.

## Query parameters

**q** `string`

Only tags containing this text, ignoring letter case (`paid` finds `call-accepted-not-paid`).
Use it to reach tags beyond the 500 most-used.

## Authentication

```bash theme={null}
Authorization: Bearer tuco_xxxxxxxxxxxxx
```

## Response

```json theme={null}
{
  "tags": [
    { "tag": "call-accepted-not-paid", "count": 12 },
    { "tag": "vip", "count": 3 }
  ],
  "truncated": false
}
```

`truncated` is `true` when the workspace has more tags than were returned. Search with `q` to find the rest.

## Errors

| Status | When |
| - | - |
| `401` | Missing or invalid API key |
| `429` | More than 120 requests a minute (shared with other read endpoints) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.