List reservations
Returns a paginated list of the organization's reservations, with service, contact and assigned_resources joined.
Endpoint
GET/reservations
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
status | string | No | Filter by status. Use status[$in][]=pending&status[$in][]=confirmed for several, or status[$ne]=cancelled. |
service_id | integer | No | Only reservations of this service. |
contact_id | integer | No | Only reservations of this contact. |
deal_id, company_id, conversation_id | integer | No | Only reservations linked to this record. |
source | string | No | One of manual, whatsapp_ai, instagram_ai, webchat, public_link, api, automation. |
date_from | string (YYYY-MM-DD) | No | Reservations starting on or after this date (service wall-clock time). |
date_to | string (YYYY-MM-DD) | No | Reservations starting on or before this date (inclusive, whole day). |
start_datetime | string | No | Range filter with operators, e.g. start_datetime[$gte]=2026-04-20T00:00:00.000Z. |
searchTerm | string | No | Case-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. |
$limit | integer | No | Page size. Default 10, maximum 50. |
$skip | integer | No | Number of records to skip. |
$sort[field] | 1 | -1 | No | Sort, e.g. $sort[start_datetime]=1. |
$select[] | string | No | Return 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.