v1

latestOpenAPI 3.0.2EULA2026-07-143221521.2 MB
Booking tickets

Get all time slots for a booking ticket

Get all available time slots for a specific booking ticket. Time slots represent the individual available appointment or event times for a bookable resource. Time slot IDs are used when creating booking items within a booking (POST /bookings).

get/booking-tickets/{booking_ticket_id}/time-slots

Path parameters

booking_ticket_idstring required

The unique ID of the booking ticket.

Query parameters

countinteger

The number of records to return in API response.

⚠️ We recommended adjust the batch size based on processing time. Depending on the response time of the request. Default value of 100 records is used if count parameter is not set.

offsetinteger

The number of records from a collection to skip. Default value of 0 is used when parameter offset is not set.

sort_fieldstring

Name of the sorting parameter. You can sort by any of the first level parameters from the resource response. Response is sorted by the specified field.

sort_direction'ASC' | 'DESC'

Direction of sorting the response list.

free_onlytrue | false

Parameter defines what kind of time slots is going to be return depends on the capacity. Possible values: true - returns all time slots with free capacity. / false - returns all occupied time slots. / no value - all time slots are returned (filter is not applied)

time_fromstring

Start of the time interval for filtering. Accepts the format YYYY-MM-DD HH:MM:SS or ISO-8601 format (YYYY-MM-DDTHH:MM:SS). All times are in the local timezone.

time_tostring

End of the time interval for filtering. Accepts the format YYYY-MM-DD HH:MM:SS or ISO-8601 format (YYYY-MM-DDTHH:MM:SS). All times are in the local timezone.

booking_ticket_property_idstring

Booking ticket property ID from resource booking-ticket-properties. The parameter determines property, which is used to filter resources by their properties. The parameter must be used in combination with property_value otherwise is ignored in the request.

booking_ticket_property_valuestring

Booking ticket property record value from booking-ticket-properties in case of datatype with multiple values. Parameter filters resources depends of store property record value. The parameter must be used in combination with property_id otherwise is ignored in the request.

customer_idstring

The unique ID of the customer. GET /customers

Headers

Accept-Languagestring

The unique ID of the language code by ISO 639-1.

Response

OK

Example response

{
  "data": {
    "time_slots": [
      {
        "time_slot_id": "89ce2a1b9b01f5c939fb1e20cd",
        "ticket_id": "89ce2a1b9b01f5c939fb1e20cd",
        "valid_from": "2022-01-09 22:00:00",
        "valid_to": "2022-01-09 22:30:00",
        "total_capacity": 50,
        "free_capacity": 20,
        "state": 1,
        "last_change": "2015-01-05 11:24:12"
      }
    ],
    "total_items": 1
  }
}