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

# List all tags

`GET /tags`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/tags`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/tags/get.ts> (a function with typed inputs; its response is checked against the schema)

This API retrieves all tags associated with the authenticated account. Tags serve as labels that help organize and filter locations.

**Response Includes:**
- Tag ID (Unique identifier)
- Tag Name (Label used for categorization)

## Headers

- `Authorization` string

## Response `200`

Successfully retrieved list of tags

- object
  - `data` object
    - `listAllTags` object[]: Array of tag objects
      - `id` string, uuid, required: Unique identifier for the tag
      - `name` string, required: Display name of the tag

## Other responses

- `401`: Unauthorized - Authentication credentials are missing or invalid
- `403`: Forbidden - User doesn't have permission to access tags
- `500`: Internal server error

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)