Developers
Bookings

List bookings

GET
/bookings

Lists the store's consultation bookings, newest first, with the customer and booked product. Filter by status or creation date.

Authorization

apiKey
headerAuthorizationBearer <token>

A store API key from Settings → Developers → API keys, sent as Authorization: Bearer zk_live_….

Query Parameters

limit?integer

Page size, 1–100

Range1 <= value <= 100
Default25
cursor?string

next_cursor from the previous page

Lengthlength <= 500
order?string

Sort by created_at; newest first by default

Default"desc"
Value in"desc""asc"
created_after?string

Only records created after this time

Formatdate-time
created_before?string

Only records created before this time

Formatdate-time
status?string
Value in"pending""accepted""canceled""initiated"

Response Body

Success

application/json
  1. response
object*"list"
Value in"list"
data*array<>
has_more*boolean

Whether another page exists

next_cursor*string

Pass as cursor to get the next page; null on the last

curl -X GET "https://example.com/bookings"
{  "object": "list",  "data": [    {      "id": "00000000-0000-4000-8000-000000000401",      "status": "pending",      "date": "2026-10-12",      "time": "14:00",      "timezone": "Asia/Riyadh",      "duration_minutes": 60,      "meeting_method": "zoom",      "meeting_link": "https://zoom.us/j/0000000000",      "order_id": "00000000-0000-4000-8000-000000000001",      "product_id": "00000000-0000-4000-8000-000000000203",      "product_name": "1:1 Business Consultation",      "customer": {        "id": "00000000-0000-4000-8000-000000000010",        "name": "Sara Ahmed",        "email": "sara@example.com",        "phone": "+966500000000"      },      "created_at": "2026-10-01T10:00:00.000Z",      "object": "booking"    }  ],  "has_more": false,  "next_cursor": null}