Skip to main content
GET
/
tag
Get all tags
curl --request GET \
  --url https://api.sendx.io/api/v1/rest/tag \
  --header 'X-Team-ApiKey: <api-key>'
[
  {
    "id": "tag_abc123def456",
    "name": "VIP Customer",
    "created": "2024-01-20T10:30:00Z",
    "updated": "2024-01-20T10:30:00Z"
  },
  {
    "id": "tag_def456ghi789",
    "name": "Newsletter Subscriber",
    "created": "2024-01-15T14:20:00Z",
    "updated": "2024-01-18T09:15:00Z"
  },
  {
    "id": "tag_ghi789jkl012",
    "name": "Webinar Attendee",
    "created": "2024-01-10T08:45:00Z",
    "updated": "2024-01-10T08:45:00Z"
  }
]

Authorizations

​
X-Team-ApiKey
string
header
required

Team API key for authentication. Find your API key in SendX Settings → Team API Key.

Example:

X-Team-ApiKey: your_team_api_key_here

Query Parameters

​
offset
integer
default:0

Number of tags to skip

Required range: x >= 0
​
limit
integer
default:10

Maximum number of tags to return

Required range: 1 <= x <= 100

Response

✅ Tags retrieved successfully

​
id
string

Unique tag identifier with tag_ prefix

Pattern: ^tag_[a-zA-Z0-9]{22}$
Example:

"tag_abc123def456ghi789"

​
name
string

Tag name

Example:

"VIP Customer"

​
created
string<date-time>

Tag creation timestamp

Example:

"2024-01-20T10:30:00Z"

​
updated
string<date-time>

Tag last update timestamp

Example:

"2024-01-20T10:30:00Z"