Ticket Types

2 endpoints

GET /{account_slug}/{event_slug}/ticket_types

list ticket types

Returns a paginated list of all ticket types for the specified event, sorted by position. Each ticket type includes pricing, capacity, and configuration details.

Requires authentication

Path parameters

Name	Description
`account_slug` string Required	The unique slug identifier for your Tito account
`event_slug` string Required	The unique slug identifier for the event

Query parameters

Name	Description
`page` integer	Page number for pagination (default: 1)
`q` string	Search ticket types by name or slug
`sort` string	Sort order. Default is by position. Use name_az for A–Z or name_za for Z–A.: * `name_az` * `name_za`

Response fields

Field	Description
`ticket_types` array
`ticket_types[].id` integer	Unique identifier for the ticket type
`ticket_types[].slug` string	URL-friendly unique identifier for the ticket type within the event
`ticket_types[].name` string	Display name of the ticket type
`ticket_types[].description` string \| null	Optional description of the ticket type
`ticket_types[].price` integer \| null	Price in cents (null or 0 for free tickets)
`ticket_types[].currency` string \| null	ISO 4217 currency code (inherited from event)
`ticket_types[].quantity` integer \| null	Maximum capacity (null for unlimited)
`ticket_types[].position` integer \| null	Sort order position
`ticket_types[].is_bundle` boolean	Whether this ticket type is a bundle of other ticket types
`ticket_types[].tax_behavior` string	Whether the price includes or excludes tax
`ticket_types[].created_at` string	Timestamp when the ticket type was created
`ticket_types[].updated_at` string	Timestamp when the ticket type was last updated
`meta` object
`meta.lookup_mode` string	Current lookup mode (live or test)
`meta.pagination` object
`meta.pagination.page` integer	Current page number
`meta.pagination.items` integer	Number of items per page
`meta.pagination.pages` integer	Total number of pages
`meta.pagination.count` integer	Total number of ticket types

Error responses

401 – unauthorized - no bearer token provided or token is invalid
403 – forbidden - API token does not have access to this event

Example request

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://api.pro.tito.io/{account_slug}/{event_slug}/ticket_types

Example response

{
  "ticket_types": [
    {
      "id": 101,
      "slug": "early-bird",
      "name": "Early bird",
      "description": "Discounted ticket for early registrants",
      "price": 10000,
      "currency": "eur",
      "quantity": 100,
      "position": 1,
      "is_bundle": false,
      "tax_behavior": "exclusive",
      "created_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-01-15T10:30:00Z"
    },
    {
      "id": 102,
      "slug": "regular",
      "name": "Regular",
      "description": null,
      "price": 20000,
      "currency": "eur",
      "quantity": null,
      "position": 2,
      "is_bundle": false,
      "tax_behavior": "exclusive",
      "created_at": "2025-01-16T14:00:00Z",
      "updated_at": "2025-01-16T14:00:00Z"
    }
  ],
  "meta": {
    "lookup_mode": "live",
    "pagination": {
      "page": 1,
      "items": 20,
      "pages": 1,
      "count": 2
    }
  }
}

GET /{account_slug}/{event_slug}/ticket_types/{id}

show ticket type

Returns detailed information about a specific ticket type, including settings, buy-x-get-y-free configuration, dependencies, and bundle items.