---
title: "GET /api/availability"
method: GET
path: "/api/availability"
---

# GET /api/availability

`GET /api/availability`

## Request

- Base URL: `https://app.drchrono.com`
- URL: `https://app.drchrono.com/api/availability`
- Auth: none declared

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:

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

Response:

```json
{
  "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:

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

Response:

```json
{
  "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:

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

Response:

```json
{
  "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
}
```

## Query parameters

- `office` integer: Office ID.
- `doctor` integer: Doctor ID.
- `date` string: Date string.
- `date_range` string: Date range string.
- `duration` integer: Duration in minutes.
- `exam_room` integer: Exam room ID.

## Response `200`

OK

- union
  - object: Availability for a date range
    - `dates` object[]
      - `date` string: Date in YYYY-MM-DD format
      - `open_slots` object[]
        - `start` string: Start time (e.g., "09:00")
        - `end` string: End time (e.g., "17:00")
        - `availability` object[]: List of available slots within the range
          - `start` string: Slot start time (e.g., "09:00")
          - `end` string: Slot end time (e.g., "09:30")
    - `office` integer: Office ID
    - `doctor` integer: Doctor ID
    - `exam_room` integer: Exam room ID
    - `date_range` string[]: Array of two date strings [start, end]
    - `duration` integer: Slot duration in minutes
  - object: Availability for a single date
    - `office` integer: Office ID
    - `doctor` integer: Doctor ID
    - `open_slots` object[]
      - `start` string: Start time (e.g., "09:00")
      - `end` string: End time (e.g., "17:00")
      - `availability` object[]: List of available slots within the range
        - `start` string: Slot start time (e.g., "09:00")
        - `end` string: Slot end time (e.g., "09:30")
    - `exam_room` integer: Exam room ID
    - `duration` integer: Slot duration in minutes
    - `date` string: Date in YYYY-MM-DD format

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Permission Denied
- `404`: Not Found
- `405`: Method Not Allowed
- `500`: Internal Server Error

## Changes

- **2026-07-13** `1f92de898aec`: 8 info
  - added the new optional `query` request parameter `exam_room`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - …4 more

[Operation history](https://skmtc.dev/drchrono/apis/drchrono-api/changes/api/availability/get.md)

---

[API](https://skmtc.dev/drchrono/apis/drchrono-api.md) - [All operations](https://skmtc.dev/drchrono/apis/drchrono-api/llms.txt) - [OpenAPI document](https://skmtc.dev/drchrono/apis/drchrono-api/revisions/98cabe79d150?raw)