Venue bookings

Event bookings across your venue's rooms. Needs a venue key — a company or restaurant key gets 403. Auth: Authorization: Bearer oac_live_<key>. A company key covers every property it owns; a venue key covers its venue. Lists are cursor-paginated.

GET/api/v1/venue-bookings

Bookings for the authenticated venue's rooms, newest event first.

Query: status, from, to (YYYY-MM-DD, on the event date), limit (≤100), cursor

200 OK

{
  "data": [
    { "id": "clo...", "room": { "id": "clr...", "name": "The Long Room" },
      "date": "2026-09-12", "startTime": "18:30", "endTime": "23:00",
      "attendees": 60, "eventType": "WEDDING", "status": "CONFIRMED", "total": 1450,
      "guest": { "name": "Sam", "email": "sam@example.com", "phone": "+44..." },
      "createdAt": "2026-07-08T10:00:00.000Z" }
  ],
  "nextCursor": null
}