A booking, as returned in API responses.
What kind of booking this is:
APPOINTMENT: a one-to-one booking for a single customer.SESSION: one scheduled run of a group class, which several customers can attend. Who is attending a session is changed with the Add a customer to a class session and Remove a customer from a class session endpoints.EVENT: a calendar entry that is not tied to a service, created with Create an event. It has noservice_id,costorlabel.
Enum:"SESSION""APPOINTMENT""EVENT"
Example:"APPOINTMENT"
Ids of the customers attending this booking.
- Appointment: always exactly 1 customer.
- Session (group class): anywhere from 0 customers up to the number of seats the class offers (the
max_seatsof its service). To change who is attending, use Add a customer to a class session or Remove a customer from a class session; updating the booking does not change it.
Example:
[ "cust_123456" ]
Start of the booking, an RFC 3339 date-time in UTC (Z). A time sent with an offset is returned as the same moment in UTC: 2026-11-19T08:30:00+08:00 is returned as 2026-11-19T00:30:00Z.
Example:"2026-01-20T09:00:00Z"
End of the booking, an RFC 3339 date-time in UTC (Z), as the same moment as it was sent.
Example:"2026-01-20T10:00:00Z"
Free-text label for the booking, e.g. a status or reminder tag such as RUNNING_LATE or NO_SHOW. Empty for an EVENT.
Example:"RUNNING_LATE"
When the booking was created, an RFC 3339 date-time in UTC (Z).
Example:"2026-01-15T12:00:00Z"
{ "id": "bk_123456", "type": "APPOINTMENT", "calendar_id": "cal_123456", "account_id": "acc_123456", "provider_id": "provider_123456", "consumer_ids": [ "cust_123456" ], "service_id": "svc_123456", "start_at": "2026-01-20T09:00:00Z", "end_at": "2026-01-20T10:00:00Z", "booking_id": "ext_bk_654321", "cost": 50, "title": "Consultation", "notes": "Customer requested a reminder call the day before.", "status": "CONFIRMED", "label": "RUNNING_LATE", "location": { "type": [ … ], "video_type": [ … ] }, "created_at": "2026-01-15T12:00:00Z", "source": "booking_page", "meta_data": { "referred_by": "google_ads" } }