Orders

2 endpoints

GET /{account_slug}/{event_slug}/orders

list orders

Returns a paginated list of all orders for the specified event. Each order includes customer details, reference number, and amount.

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
`orders` array
`orders[].id` integer	Unique identifier for the order
`orders[].customer` object	Customer details for the order
`orders[].customer.first_name` string	First name of the person who placed the order
`orders[].customer.last_name` string	Last name of the person who placed the order
`orders[].customer.email` string	Email address of the person who placed the order
`orders[].reference` string	Unique reference code for the order
`orders[].currency` string	ISO 4217 currency code
`orders[].amount` integer	Total amount in cents
`orders[].created_at` string	Timestamp when the order was created
`orders[].updated_at` string	Timestamp when the order 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 orders

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}/orders

Example response

{
  "orders": [
    {
      "id": 123456,
      "name": "John Smith",
      "email": "john@example.com",
      "reference": "ABCD-1234",
      "amount": {
        "cents": 15000,
        "currency_iso": "USD"
      },
      "created_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-01-15T10:30:00Z"
    },
    {
      "id": 123457,
      "name": "Jane Doe",
      "email": "jane@example.com",
      "reference": "EFGH-5678",
      "amount": {
        "cents": 30000,
        "currency_iso": "USD"
      },
      "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}/orders/{id}

show order

Returns detailed information about a specific order, including customer details, invoice, and associated tickets.