Docs API reference

Sign in

Sign in

Docs API reference

Tickets

2 endpoints

GET /{account_slug}/{event_slug}/tickets

list tickets

Returns a paginated list of all tickets (attendees) for the specified event. Each ticket represents an individual attendee and includes their name, email, and associated order.

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)

Response fields

Field	Description
`tickets` array
`tickets[].id` integer	Unique identifier for the ticket
`tickets[].name` string	Full name of the ticket holder/attendee
`tickets[].email` string \| null	Email address of the ticket holder (may be null if not provided)
`tickets[].order_id` integer	ID of the order this ticket belongs to

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.staging.pro.tito.io/{account_slug}/{event_slug}/tickets

Example response

{
  "tickets": [
    {
      "id": 123456,
      "name": "Jane Smith",
      "email": "jane@example.com",
      "order_id": 789
    },
    {
      "id": 123457,
      "name": "Bob Johnson",
      "email": "bob@example.com",
      "order_id": 790
    }
  ]
}

GET /{account_slug}/{event_slug}/tickets/{id}

show ticket

Returns detailed information about a specific ticket (attendee). By default the response includes `order_id` and `ticket_type_id` rather than the full associated objects. To get the full object inline, add it to the `include` query parameter (comma-separated, e.g. `include=order,ticket_type`). Each included object has the same fields as its own show endpoint.

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
`id` string Required	The unique identifier for the ticket

Response fields

Field	Description
`id` integer	Unique identifier for the ticket
`reference` string	Human-readable reference for the ticket
`test_mode` boolean	Whether the ticket was created in test mode
`state` string	Whether the ticket has all required details (name, email, required custom field answers).
`cancelled` boolean	Whether the ticket has been cancelled. Orthogonal to state — a cancelled ticket can be either incomplete or complete.
`name` string	Full name of the ticket holder/attendee
`email` string \| null	Email address of the ticket holder (may be null if not provided)
`phone_number` string \| null	Phone number of the ticket holder
`ticket_type_id` integer	ID of the ticket type this ticket was issued for (only present when include=ticket_type is not specified)
`ticket_type` object	Embedded ticket type — only present when `include=ticket_type` is set. Same fields as the ticket types show endpoint.
`custom_data` object	Answers to custom fields, keyed by question slug (only present when answers exist)
`created_at` string	When the ticket was issued
`updated_at` string	When the ticket was last updated
`cancelled_at` string \| null	When the ticket was cancelled, or null if not cancelled
`order_id` integer	ID of the order this ticket belongs to (only present when include=order is not specified)
`order` object	Embedded order — only present when `include=order` is set. Same fields as the orders show endpoint.

Error responses

401 – unauthorized - no bearer token provided or token is invalid
403 – forbidden - API token does not have access to this event
404 – not found - ticket ID does not exist or is not accessible

Example request

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

Example response

{
  "id": 123456,
  "reference": "ABCD-1",
  "test_mode": false,
  "state": "complete",
  "cancelled": false,
  "name": "Jane Smith",
  "email": "jane@example.com",
  "phone_number": "+353 1 234 5678",
  "ticket_type_id": 42,
  "custom_data": {
    "track": "Frontend",
    "difficulty": "Intermediate"
  },
  "created_at": "2026-02-08T10:30:00Z",
  "updated_at": "2026-02-08T10:30:00Z",
  "cancelled_at": null,
  "order_id": 789
}

← Previous Ticket Types Next → Webhook Events