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

# List tags

`GET /tags`

## Request

- Base URL: `https://public-api.alternativepayments.io`
- URL: `https://public-api.alternativepayments.io/tags`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/oauth/token` scopes: `tags:read`

List all tags owned by the partner, including system tags. Use the returned IDs to tag customers.

## Query parameters

- `name` string
- `customer_id` string
- `limit` integer
- `after` string
- `before` string

## Response `200`

OK

- PaginatedResponseTagReply
  - `data` TagReply[]
    - `color` string
    - `customer_count` integer
    - `description` string
    - `id` string
    - `name` string
    - `partner_id` string
    - `type` string
  - `end_cursor` string
  - `has_next_page` boolean
  - `has_previous_page` boolean
  - `start_cursor` string

## Other responses

- `400`: Bad Request
- `503`: Service Unavailable
- `504`: Gateway Timeout

## Changes

- **2026-10-20** `7b8246f9fc1c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/alternativepayments/apis/alternative-payments/changes/tags/get.md)

---

[API](https://skmtc.dev/alternativepayments/apis/alternative-payments.md) - [All operations](https://skmtc.dev/alternativepayments/apis/alternative-payments/llms.txt) - [OpenAPI document](https://skmtc.dev/alternativepayments/apis/alternative-payments/revisions/281251358a5b?raw)