Operation
Get a tag definition
GET
/tag-definitions/{id}Path parameters
idstringRequired
Returns
Tag definition 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/tag-definitions/tgd_abc123" \ -H "Authorization: Bearer tlak_..." \ -H "X-Ticketlayer-Org: your-org-slug"Response 200
{
"tagDefinition": {
"id": "tgd_abc123",
"slug": "member",
"label": "Members",
"description": "Current club members",
"kind": "customer",
"appliesTo": [
"customers"
],
"grantableBy": [
"staff",
"code"
],
"autoDefined": false,
"archivedAt": null,
"createdAt": "2026-09-24T10:00:00.000Z",
"updatedAt": "2026-09-24T10:00:00.000Z"
}
}