Retrieve availability slots for the given date and office, doctor, or exam room.

If the exam_room parameter is not specified, the response will include availability for all exam rooms in the payload, grouped by exam room.

Example 1: Get availability for a single date

Request:

GET /api/availability?date=2026-01-29&office=338939&duration=30

Response:

{
  "duration": 30,
  "date": "2026-01-29",
  "open_slots": [
    {
      "start": "09:00",
      "end": "17:00",
      "availability": [
        { "start": "09:00", "end": "09:30" },
        { "start": "09:30", "end": "10:00" },
        { "start": "10:00", "end": "10:30" }
      ]
    }
  ],
  "office": 338939
}

Example 2: Get availability for a date range

Request:

GET /api/availability?date_range=2026-01-29/2026-01-30&office=338939&duration=30

Response:

{
  "date_range": ["2026-01-29", "2026-01-30"],
  "duration": 30,
  "office": 338939,
  "dates": [
    {
      "date": "2026-01-29",
      "open_slots": [
        {
          "start": "09:00",
          "end": "17:00",
          "availability": [
            { "start": "09:00", "end": "09:30" },
            { "start": "09:30", "end": "10:00" }
          ]
        }
      ]
    },
    {
      "date": "2026-01-30",
      "open_slots": []
    }
  ]
}

Example: Get availability for a specific exam room

Request:

GET /api/availability?date=2026-01-29&office=338939&duration=30&exam_room=2

Response:

{
  "duration": 30,
  "date": "2026-01-29",
  "open_slots": [
    {
      "start": "09:00",
      "end": "17:00",
      "availability": [
        { "start": "09:00", "end": "09:30" },
        { "start": "09:30", "end": "10:00" },
        { "start": "10:00", "end": "10:30" }
      ]
    }
  ],
  "office": 338939,
  "exam_room": 2
}