---
title: "List all Tags | Nuvio Docs"
description: "Retrieves all tags"
url: https://nuvio.io/docs/api/list-tags
---

# List all Tags

GET `/v1/tags`

Needs an API key with the [`read`](https://nuvio.io/docs/api/authentication#scopes) scope.

## Returns

Every tag of the access token's company.

`401`

No usable `Authorization: Bearer {token}` header (1002).

`403`

The access token is unknown, or lacks the scope this route needs (1001).

GET /v1/tags

```
curl https://api.nuvio.io/v1/tags \
  -H "Authorization: Bearer $NUVIO_API_TOKEN"
```

Response

```
{
  "success": true,
  "errors": null,
  "data": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "name": "Acme Supplies"
    }
  ]
}
```