Bookings API
GET /api/v1/bookings
List bookings
Returns bookings one page at a time. Requires the read:bookings scope (or * for full access).
GET /api/v1/bookings?scope=upcoming&hostUserId=cmq1user0alk34567890&limit=50 HTTP/1.1
Host: agentlyleads.com
Authorization: Bearer alk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxQuery parameters
| Parameter | Default | Description |
|---|---|---|
scope | upcoming | upcoming (confirmed, not yet ended, soonest first), past (confirmed, ended), cancelled, or all. Everything but upcoming runs newest first |
hostUserId | all hosts | Only this host's bookings |
from | none | Only bookings starting at or after this ISO 8601 date or datetime |
to | none | Only bookings starting before this ISO 8601 date or datetime |
limit | 50 | Page size, 1 to 200 |
cursor | none | The nextCursor from the previous page |
Response: 200
{
"bookings": [
{ "id": "cmq9book0alk34567890", "status": "CONFIRMED", "startAt": "2026-10-05T13:00:00.000Z", "...": "..." }
],
"nextCursor": "cmq9book0alk34567890"
}nextCursor is null on the last page. Each item is a Booking object.
Get one booking
GET /api/v1/bookings/cmq9book0alk34567890 HTTP/1.1Returns { "booking": { ... } }, or 404 with { "error": "Booking not found." } when the ID is not in this workspace.