List tags and folders

GET /v1/tags

Auth required api.tags.view

Returns the org's tag vocabulary, ordered by full path. Tags are org-side annotations shared across Lists, Segments and Templates and double as Gmail-style folders (nest via / in the name). Tag lifecycle and assignment are dashboard-only; this API is read-only. Cursors are opaque base64; stale or malformed cursors silently fall back to page 1.

Query parameters

limit integer optional

Page size (1–200). Default 50.

cursor string optional

Opaque cursor returned from the previous page.

Responses

200 Cursor-paginated list of tags, by path application/json

401 Missing, malformed, or unknown API key application/problem+json

403 Key lacks the required scope or plan limit violated application/problem+json

422 Query parameter or path value failed validation application/problem+json

429 Per-org rate limit exceeded application/problem+json

500 Unexpected server-side failure. The code is internal_error. The request_id field can be quoted to SendOps support to investigate. application/problem+json

{ "data": [ { "id": "00000000-0000-0000-0000-000000000000", "name": "string", "key": "string", "color": "string", "description": "string", "created_at": "2026-05-17T20:00:00Z", "updated_at": "2026-05-17T20:00:00Z" } ], "pagination": { "has_more": true, "next_cursor": "string" } }