Waitlist

When a slot is full, join a customer to the waitlist for that venue / resource / date.

Auth: x-api-key. Entries are scoped to your partner.

Waitlist join is naturally idempotent on (venue_id, resource_id, slot_date, customer_phone). There is no idempotency_key. Retrying the same join resets status to waiting and refreshes expires_at.

Join

POST /api/v1/waitlist
Content-Type: application/json
x-api-key: <your-api-key>

{
  "venue_id": "a0000000-0000-4000-8000-000000000001",
  "resource_id": "badminton-court-1",
  "slot_date": "2026-09-20",
  "customer_phone": "9876543210",
  "customer_name": "Aarav Sharma"
}

Optional expires_in_days (default 7). Omit partner_id.

201: { "entry": { … } }.

List

GET /api/v1/waitlist?venue_id=<uuid>&resource_id=badminton-court-1&slot_date=2026-09-20
x-api-key: <your-api-key>

venue_id, resource_id, and slot_date are required. Optional status: waiting | promoted | expired | cancelled.

Cancel an entry

DELETE /api/v1/waitlist/{entryId}
x-api-key: <your-api-key>

204. Missing or not yours → 404.