Skip to content

Availability

Catalogue of slots for one venue on one calendar date.

Auth: x-api-key. The venue must be granted (403 VENUE_NOT_AUTHORIZED otherwise).

http
GET /api/v1/slots/availability?venue_id=<uuid>&date=2026-09-20&resource_id=badminton-court-1
x-api-key: <your-api-key>

resource_id is optional. date is YYYY-MM-DD.

json
{
  "venue_id": "a0000000-0000-4000-8000-000000000001",
  "date": "2026-09-20",
  "slots": [
    {
      "slot_id": "…",
      "resource_id": "badminton-court-1",
      "slot_start": "2026-09-20T06:00:00.000Z",
      "slot_end": "2026-09-20T07:00:00.000Z",
      "price_rupees": 500,
      "is_available": true
    }
  ]
}

is_available: true is not a reservation. Another channel can hold the slot before your hold call returns. Always hold before you promise the customer the court.

Use the returned slot_start and duration. Do not invent overlapping windows.

Start in the sandbox. Production access is granted after certification.