Operation

List tag definitions

GET/tag-definitions

The organisation's tag definitions, by slug. Archived ones are left out unless includeArchived=true.

Query parameters

kindOptional: What kind of tag this is: a customer tag (what benefits were), an event, venue, ticket-type or price tag. Products follow with tag-granting products.
appliesToOptional: Something a tag may be applied to
includeArchivedstringOptional: Include archived definitions; they are left out by default

Returns

Tag definitions 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" \  -H "Authorization: Bearer tlak_..." \  -H "X-Ticketlayer-Org: your-org-slug"

Response 200

{
  "tagDefinitions": [
    {
      "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"
    }
  ]
}

List tag definitions

Query parameters

Returns

Errors

Try it in test mode

Query parameters