PrepaidAIDocsv1
StatusConsole
GET/api/v1/bookings

List bookings

Appointments from now until a number of days ahead, soonest first.

1 min read
GET
curl "https://app.prepaid.ai/api/v1/bookings?days_ahead=14" \  -H "Authorization: Bearer $PREPAID_API_KEY"
Response · 200
{  "workspaceId": "3f6c1e70-9a4d-4a58-b6a2-2f0f0f9d1c11",  "from": "2026-10-29T00:00:00.000Z",  "to": "2026-11-12T00:00:00.000Z",  "bookings": [    {      "id": "e2b7c1d0-8f3a-4b6c-9d2e-1f0a3b4c5d6e",      "service": "Check-up",      "startsAt": "2026-10-30T21:00:00.000Z",      "endsAt": "2026-10-30T21:30:00.000Z",      "customerName": "Aroha Ngata",      "customerPhone": "+64211234567",      "customerEmail": null,      "notes": null,      "status": "confirmed",      "bookedBy": "ai"    }  ]}

Appointments from now until days_ahead days ahead, soonest first. Cancelled ones are left out.

Query parameters

days_aheadintegeroptional
1–90, default 14.

Response

fromstringalways present
Start of the window — now.
tostringalways present
End of the window.
bookings[].idstringalways present
The booking’s id.
bookings[].servicestringalways present
What it is for.
bookings[].startsAtstringalways present
Start time.
bookings[].endsAtstringalways present
End time.
bookings[].customerNamestringalways present
Who it is for.
bookings[].customerPhonestring | nullalways present
Their number.
bookings[].customerEmailstring | nullalways present
Their email.
bookings[].notesstring | nullalways present
Anything noted with it.
bookings[].statusstringalways present
confirmed, pending, completed or no_show.
bookings[].bookedBystringalways present
ai, booking_page or owner. See Bookings.