POST list_bookings
Bookings with customer, services, date, arrival time, provider and price.
read
Lists bookings in one folder: upcoming, unassigned, drafts and quotes, or cancelled. Filter by date range, customer or provider. Pages follow the order of the folder; pass next_cursor back as cursor. Quotes in drafts_quotes carry the quote_id that send_quote needs.
POST /api/v1/bookingkoala/list_bookings
Input
| Parameter | Type | Description |
|---|---|---|
| folder | enum | upcoming, unassigned, drafts_quotes or cancelled. Default: upcoming. |
| from | date | Only bookings on or after this date. |
| to | date | Only bookings on or before this date. |
| customer_id | string | Only bookings of this customer. |
| provider_id | string | Only bookings of this provider or team. |
| cursor | string | Next page cursor from the previous call. |
Example response
{
"bookings": [
{
"booking_id": "48213",
"customer": {
"customer_id": "1207",
"name": "Sarah Miller"
},
"services": [
"Deep clean"
],
"arrival": "2026-10-15T09:00:00-05:00",
"provider": null,
"folder": "unassigned",
"price": "180.00"
}
],
"next_cursor": null
}