Skip to main content
GET
List bookings

Authorizations

Authorization
string
header
required

Organization-scoped bearer credential: a customer API key (1club_sk_live_...) or an MCP OAuth access token.

Query Parameters

from
string

Inclusive lower bound on booking start time, as an ISO date-time or YYYY-MM-DD. Defaults to to - 7d, or now.

to
string

Exclusive upper bound on booking start time, as an ISO date-time or YYYY-MM-DD. Defaults to from + 7d.

clubId
integer

Only bookings at this club

areaId
integer

Only bookings on this area

classId
integer

Only the attendees of this class occurrence. Equivalent to GET /v1/platform/classes/{id}/bookings, which additionally resolves each attendee's name and check-in.

eventId
integer

Only bookings for this event

instructorId
integer

Only bookings led by this instructor

contactId
integer

Only bookings for this contact

status
string

Only bookings with this status (e.g. confirmed, pending, cancelled)

include
enum<string>

Embed each booking's customer as customer, identical to what GET /v1/platform/contacts/{id} returns - one request instead of a contact lookup per booking. Requires the contacts:read scope in addition to bookings:read, and is refused with 403 without it.

Available options:
customer
limit
integer
default:50

Maximum number of bookings to return

Required range: 1 <= x <= 100
offset
integer
default:0

Number of bookings to skip

Required range: x >= 0

Response

Page of bookings

data
object[]
total
integer

Total bookings matching the filters, ignoring pagination

limit
integer
offset
integer