Operation
List customer tags
GET
/customers/{customerId}/tagsLists the tags a customer holds: lasting, channel-independent grants that ticket types and listing windows reference by slug. includeRevoked=true includes revoked grants.
Path parameters
customerIdstringRequired- Customer ID
Query parameters
includeRevokedstringOptional
Returns
Customer tags retrieved successfully
Errors
- 400
- Bad Request - Invalid input
- 401
- Unauthorized - Authentication required
- 403
- Forbidden - Insufficient permissions
- 404
- Not Found - Resource not found
- 500
- Internal Server Error
Every error names its code and links to it. All error codes
curl -X GET "https://api.ticketlayer.com/v1/customers/cus_abc123/tags" \ -H "Authorization: Bearer tlak_..." \ -H "X-Ticketlayer-Org: your-org-slug"Response 200
{
"customerTags": [
{
"id": "cent_abc123",
"customerId": "cus_abc123",
"tag": "member",
"tagDefinitionId": "tgd_abc123",
"source": "manual",
"expiresAt": "2026-12-31T23:59:59.000Z",
"revokedAt": null,
"revokedBy": null,
"revokeReason": null,
"grantedBy": "usr_abc123",
"metadata": {},
"extensions": [
{
"previousExpiresAt": "2026-09-30T23:59:59.000Z",
"expiresAt": "2027-09-30T23:59:59.000Z",
"extendedAt": "2026-09-20T10:30:00.000Z",
"extendedBy": "client:oak_abc123",
"source": "membership",
"metadata": {
"membershipId": "mem_2027"
}
}
],
"createdAt": "2026-09-24T10:30:00.000Z",
"updatedAt": "2026-09-24T10:30:00.000Z"
}
]
}