List bookings | Slotflow Docs

List bookings for your organization with optional filters. Results are ordered by start time (most recent first) and paginated.

Authentication

AuthorizationBearer

API key authentication. Pass your key as a Bearer token:

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx

Get your API key from the Slotflow Dashboard.

API key authentication. Pass your key as a Bearer token: ``` Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx ``` Get your API key from the [Slotflow Dashboard](https://app.slotflow.dev).

Query parameters

human_idstringOptionalformat: "uuid"

Filter by human ID

statusenumOptional

Filter by booking status

Allowed values:

date_fromdateOptional

Filter bookings starting on or after this date

date_todateOptional

Filter bookings starting on or before this date

limitintegerOptional<=100Defaults to 50

Number of results to return (default 50, max 100)

offsetintegerOptionalDefaults to 0

Number of results to skip for pagination (default 0)

Response

Paginated list of bookings

bookingslist of objects

totalinteger

Total matching bookings (for pagination)

limitinteger

Number of results returned

offsetinteger

Number of results skipped

1	{
2	"bookings": [
3	{
4	"id": "b9e4f2a1-3c5d-4e6f-8a9b-0c1d2e3f4a5b",
5	"human_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
6	"starts_at": "2026-03-10T14:00:00.000Z",
7	"ends_at": "2026-03-10T14:30:00.000Z",
8	"duration_minutes": 30,
9	"attendee_name": "Alex Rivera",
10	"attendee_email": "alex@startup.io",
11	"status": "confirmed",
12	"metadata": {
13	"lead_id": "lead_8294"
14	},
15	"created_at": "2026-03-10T10:00:00.000Z"
16	}
17	],
18	"total": 847,
19	"limit": 50,
20	"offset": 0
21	}

1	curl https://api.slotflow.dev/v1/bookings \
2	-H "Authorization: Bearer <token>"