Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.aspect.systems/llms.txt

Use this file to discover all available pages before exploring further.

Creating a reservation requires a 3-step process:
1

Find the division you want to reserve for

2

Find available slots and their offerings

3

Create the reservation

​
Step 1: Find Division

Use the divisions endpoint to find the division ID you want to reserve for. 
GET /v1/organizations/{organization}/divisions
The response includes division IDs needed to filter slots in the next step.

List Divisions

Get available divisions

​
Step 2: Find Slots & Offerings

Query available slots and include the rates to see what offerings are available. 
GET /v1/organizations/{organization}/slots?filter[division_id]={division_id}&filter[date]={date}&include=rates
Filters:
  • filter[division_id] - Filter by division
  • filter[date] - Filter by date (YYYY-MM-DD)
Include:
  • include=rates - Returns available offerings/rates per slot
Each rate includes:
  • id - The rate ID (used when creating a reservation)
  • offering_type - Either ticket or bundle
  • offering_id - The ID of the ticket or bundle
  • offering_name - Human-readable name
  • price - Price in cents

List Slots

Find available time slots

​
Step 3: Create Reservation

Create the reservation with customer details and entries. 
POST /v1/organizations/{organization}/reservations
Request Body: 
{
  "customer": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "[email protected]",
    "phone": "+15145551234"
  },
  "entries": [
    {
      "rate_id": "310476121357873154"
    }
  ]
}
Entry fields:
  • rate_id - The rate ID from the slot’s included rates
  • first_name (optional) - Attendee first name
  • last_name (optional) - Attendee last name

Create Reservation

Create a new reservation

​
Important Notes

​
Terms & Conditions

When creating reservations through the API, you are responsible for collecting and storing terms and conditions acceptance from your customers. The API does not track T&C acknowledgment for partner-created reservations. Ensure your booking flow includes appropriate terms acceptance before calling this endpoint.