---
title: "Get tags"
method: GET
path: "/tags"
tags: ["Tags"]
---

# Get tags

`GET /tags`

## Request

- Base URL: `https://api.sandbox.monite.com/v1`
- URL: `https://api.sandbox.monite.com/v1/tags`
- Auth: HTTP bearer

Get a list of all tags. Tags can be assigned to resources to assist with searching and filtering.
    Tags can also be used as trigger conditions in payable approval policies.

    Optional filters:
    - `category`: Return only tags that belong to the specified category.
    - `category__in`: Return tags that belong to any of the specified categories.

## Query parameters

- `order` 'asc' | 'desc'
- `limit` integer
- `pagination_token` string
- `sort` 'created_at' | 'updated_at'
- `created_by_entity_user_id` string, uuid
- `name__in` string
- `id__in` string, uuid
- `category` 'document_type' | 'department' | 'project' | 'cost_center' | 'vendor_type' | 'payment_method' | 'approval_status'
- `category__in` 'document_type' | 'department' | 'project' | 'cost_center' | 'vendor_type' | 'payment_method' | 'approval_status'

## Headers

- `x-monite-version` string, required
- `x-monite-entity-id` string, required

## Response `200`

Successful Response

- TagsPaginationResponse: A paginated list of tags.
  - `data` TagReadSchema[], required
    - `id` string, uuid, required: A unique ID of this tag.
    - `created_at` string, date-time, required: Date and time when the tag was created. Timestamps follow the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) standard.
    - `updated_at` string, date-time, required: Date and time when the tag was last updated. Timestamps follow the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) standard.
    - `category` 'document_type' | 'department' | 'project' | 'cost_center' | 'vendor_type' | 'payment_method' | 'approval_status'
    - `created_by_entity_user_id` string, uuid: ID of the user who created the tag.
    - `description` string: The tag description.
    - `name` string, required: The tag name.
  - `next_pagination_token` string: A token that can be sent in the `pagination_token` query parameter to get the next page of results, or `null` if there is no next page (i.e. you've reached the last page).
  - `prev_pagination_token` string: A token that can be sent in the `pagination_token` query parameter to get the previous page of results, or `null` if there is no previous page (i.e. you've reached the first page).

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `406`: Not Acceptable
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/monite/apis/monite-3.md) - [All operations](https://skmtc.dev/monite/apis/monite-3/llms.txt) - [OpenAPI document](https://skmtc.dev/monite/apis/monite-3/revisions/c13be6f83ce9?raw)