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

# List all tags

`GET /tags`

## Request

- Base URL: `https://api.presscart.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.presscart.com/tags`
- Auth: HTTP bearer

Retrieve a list of all tags.

## Query parameters

- `limit` number, nullable
- `page` number, nullable
- `order_by` 'asc' | 'desc'
- `sort_by` string
- `include_archived` 'true' | 'false'
- `skip_pagination` 'true' | 'false'
- `filters` object
  - `fetch_all` 'true' | 'false'
  - `existing_tags` string[]
  - `search` string
  - `category` 'TOPIC' | 'AUDIENCE' | 'LOCATION' | 'ROLE' | 'COMPANY_SIZE'

## Response `200`

Tags retrieved successfully

- object
  - `total_pages` number, required
  - `current_page` number, required
  - `next_page` number, nullable, required
  - `previous_page` number, nullable, required
  - `records` union, required
    - Tag[]
      - `id` string, uuid, required
      - `name` string, required
      - `prefix` string, required
      - `category` 'TOPIC' | 'AUDIENCE' | 'LOCATION' | 'ROLE' | 'COMPANY_SIZE', required
      - `created_at` union, required
        - string, nullable
        - string
        - unknown
      - `updated_at` union, required
        - string, nullable
        - string
        - unknown
      - `deleted_at` union, required
        - string, nullable
        - string
        - unknown
    - object[]
      - `name` string, required
  - `total_records` number, required

---

[API](https://skmtc.dev/presscart/apis/presscart-prod-api.md) · [All operations](https://skmtc.dev/presscart/apis/presscart-prod-api/llms.txt) · [OpenAPI document](https://skmtc.dev/presscart/apis/presscart-prod-api/revisions/2154581d845e?raw)