List Tags

GET /tags

List all tags for your account. Optionally filter by a search term that matches against name, slug, or description.

Query Parameters

Parameter	Type	Required	Description
search	string	No	Filter tags by name, slug, or description

Examples

List all tags

curl https://api.getnexor.ai/api/public/tags \
  -H "X-API-Key: nxr_live_your_api_key"

Search tags

curl "https://api.getnexor.ai/api/public/tags?search=vip" \
  -H "X-API-Key: nxr_live_your_api_key"

Responses

200 — Successful response

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174001",
      "name": "VIP Client",
      "slug": "vip-client",
      "description": "High-priority leads",
      "created_at": "2026-01-15T09:00:00Z",
      "updated_at": "2026-01-15T09:00:00Z"
    }
  ]
}

Response Fields — Tag

Field	Type	Description
id	string (uuid)	Unique tag identifier
name	string	Tag display name
slug	string	URL-friendly tag identifier, unique per account
description	string | null	Tag description
created_at	string (date-time)	When the tag was created
updated_at	string (date-time)	When the tag was last updated

401 — Authentication error

See Authentication.

500 — Internal server error