List reservations

Returns a paginated list of the organization's reservations, with service, contact and assigned_resources joined.

Endpoint

GET
/reservations

Query parameters

NameTypeRequiredDescription
statusstringNoFilter by status. Use status[$in][]=pending&status[$in][]=confirmed for several, or status[$ne]=cancelled.
service_idintegerNoOnly reservations of this service.
contact_idintegerNoOnly reservations of this contact.
deal_id, company_id, conversation_idintegerNoOnly reservations linked to this record.
sourcestringNoOne of manual, whatsapp_ai, instagram_ai, webchat, public_link, api, automation.
date_fromstring (YYYY-MM-DD)NoReservations starting on or after this date (service wall-clock time).
date_tostring (YYYY-MM-DD)NoReservations starting on or before this date (inclusive, whole day).
start_datetimestringNoRange filter with operators, e.g. start_datetime[$gte]=2026-04-20T00:00:00.000Z.
searchTermstringNoCase-insensitive text search over the contact's first name, last name, full name and email, the service name, customer_notes and internal_notes. When used without $sort, results are sorted by start_datetime ascending.
$limitintegerNoPage size. Default 10, maximum 50.
$skipintegerNoNumber of records to skip.
$sort[field]1 | -1NoSort, e.g. $sort[start_datetime]=1.
$select[]stringNoReturn only these fields.

Any other field of the reservation object can be used as a filter. Results are limited to the API key's organization automatically.

Request

Search by customer name or email:

Response

json

Each item contains every field of the reservation object (shortened above).

Report an issue with this documentation

Please log in to report issues with our documentation.