List bookings

GET

https://prod.your-api-server.com/bookings

Last modified:2026-04-29 08:11:09

Lists bookings across the tenant, newest first. Optional
locationId scopes the result to a single business
location; optional date scopes to a single calendar day
in the location's local time zone (or UTC when no location is supplied).
Capped at 100 most-recent results.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://prod.your-api-server.com/bookings?locationId&date' \
--header 'Authorization: Bearer <token>'

Responses

🟢200

application/json

Body

Example

{
    "items": [
        {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "publicId": "string",
            "businessLocationId": "84527a82-7de9-4552-9101-e217e0c1ba3a",
            "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
            "customerName": "string",
            "customerEmail": "string",
            "customerPhone": "string",
            "status": "string",
            "totalCents": 0,
            "startsAt": "2019-08-24T14:15:22.123Z",
            "endsAt": "2019-08-24T14:15:22.123Z",
            "completedAt": "2019-08-24T14:15:22.123Z",
            "notes": "string",
            "createdAt": "2019-08-24T14:15:22.123Z",
            "items": [
                {
                    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                    "reservableVariantId": "9690f75d-e491-408d-adc6-ca59c38a215c",
                    "staffMemberId": "138ee295-38b9-456a-b430-39719940f4cd",
                    "serviceName": "string",
                    "startsAt": "2019-08-24T14:15:22.123Z",
                    "endsAt": "2019-08-24T14:15:22.123Z",
                    "priceCents": 0
                }
            ]
        }
    ]
}

🟠401

🟠429

🔴500

Modified at 2026-04-29 08:11:09

List availability slots

Create a booking