Segments
List tags
Retrieve all segment tags with member counts.
GET /app/segments/tags
Returns tag definitions and registry member counts. Requires admin role and the organization segments feature.
Request
See API Basics for required headers.
This endpoint takes no request body or query parameters.
Sample request
curl https://api.statusdashboard.com/app/segments/tags \
-H "Authorization: Bearer bcf847abf5c6:def456"Sample response
Status: 200 OK
{
"tags": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "Executive",
"memberCount": 42,
"createdAt": "2026-06-01T10:00:00.000Z",
"updatedAt": "2026-06-01T10:00:00.000Z"
},
{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"name": "Director",
"memberCount": 12,
"createdAt": "2026-06-01T10:05:00.000Z",
"updatedAt": "2026-06-01T10:05:00.000Z"
}
],
"limits": {
"segmentTags": 50
}
}Response fields
| Field | Type | Description |
|---|---|---|
tags | array | All tag definitions for the org. |
tags[].id | string | Tag UUID. |
tags[].name | string | Display name. |
tags[].memberCount | number | Registry assignments for this tag (all contacts, not just active subscribers). |
tags[].createdAt | string | ISO 8601 creation timestamp. |
tags[].updatedAt | string | ISO 8601 last-update timestamp. |
limits.segmentTags | number | Organization limit for max tags. |
Error responses
| Status | When |
|---|---|
403 | Caller is not an org admin, or the organization segments feature is not enabled. |