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

Parameters

Name	In	Type	Required	Description
`account_slug`	path	string	Yes	The unique slug identifier for your Tito account
`event_slug`	path	string	Yes	The unique slug identifier for the event
`page`	query	integer	No	Page number for pagination (default: 1)

Response fields

Field	Type	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.staging.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.