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

# List tags

`GET /tags`

Retrieve a list of all tags currently in use. The returned list is
[paginated](#pagination) and can be scrolled by following the `next`
and `prev` links where present. Results are ordered lexicographically.
The `transactions` relationship for each tag exposes a link
to get the transactions with the given tag.

## Query parameters

- `page[size]` integer

## Response `200`

Successful Response

- ListTagsResponse — Successful response to get all tags. This returns a paginated list of tags, which can be scrolled by following the `prev` and `next` links if present.
  - `data` TagResource[], required — The list of tags returned in this response.
    - `type` string, required — The type of this resource: `tags`
    - `id` string, required — The label of the tag, which also acts as the tag’s unique identifier.
    - `relationships` object, required
      - `transactions` object, required
        - `links` object
          - `related` string, required — The link to retrieve the related resource(s) in this relationship.
  - `links` object, required
    - `prev` string, nullable, required — The link to the previous page in the results. If this value is `null` there is no previous page.
    - `next` string, nullable, required — The link to the next page in the results. If this value is `null` there is no next page.

## Changes

- **2020-08-15** (v1) `f3c8cf9cc9e6` — 1 info
  - endpoint added
- **2020-07-21** (v1) `2ac77a5de971` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/up-banking/apis/up-api/changes/tags/get.md)

---

[API](https://skmtc.dev/up-banking/apis/up-api.md) · [All operations](https://skmtc.dev/up-banking/apis/up-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/up-banking/up-api/revisions/cc6a5e6d809d/schema)