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
curl https://api.getnexor.ai/api/public/tags \
-H "X-API-Key: nxr_live_your_api_key"
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
Last modified on June 18, 2026
