Developers
Bookings

Get a booking

GET
/bookings/{id}

Returns one consultation booking.

Authorization

apiKey
headerAuthorizationBearer <token>

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

Path Parameters

id*string

The resource id

Formatuuid

Response Body

Success

application/json
  1. response
id*string
status*string
Value in"pending""accepted""canceled""initiated"
date*string

YYYY-MM-DD

time*string

HH:mm in the booking timezone

timezone*string
duration_minutes*integer
meeting_method*string
meeting_link*string
order_id*string
product_id*string
product_name*string
customer*
created_at*string

ISO 8601 timestamp

object*"booking"
Value in"booking"
curl -X GET "https://example.com/bookings/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "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"}

List bookings GET

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

Accept a booking POST

Accepts a pending booking. Works only while the booking is `pending` or `initiated`. The customer is notified and `booking.accepted` fires.