> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Получить доступное время

> Получить время начала доступных для записи слотов в одной локации

Возвращает доступное для записи время начала слотов для одной локации в запрошенном интервале. Слоты
формируются на основе `open_hours` локации за вычетом глобальных и локальных заблокированных дат, а также
уже оформленных записей Aniva, поэтому результат отражает слоты, которые твои пациенты действительно
могут забронировать на стороне клиента.

Требуется scope `appointments_schedule`. Локация также должна входить в контекст доступа группы локаций твоего API-ключа.

> [!NOTE]
>
> Используй этот эндпоинт вместо того, чтобы вычислять доступность по статическому полю `open_hours`
> из [Списка локаций](https://docs.anivahealth.com/ru/api/locations/list-locations.md) — только этот эндпоинт учитывает актуальные бронирования,
> исключения в расписании по датам и 12-часовой [минимальный
> срок уведомления](https://docs.anivahealth.com/ru/api/appointments/create-appointment.md#minimalniy-srok-do-zapisi) в локациях под управлением Aniva.
> Каждый возвращаемый здесь слот доступен для записи как есть.

Ответы содержат заголовок `Cache-Control: private, max-age=30, stale-while-revalidate=60`, поэтому
браузер может отдавать кэшированный ответ до \~30 секунд — слот, занятый в это окно, может ещё
отображаться как доступный до следующего обновления. Показывай конфликты и на этапе записи.

## Параметры пути

**id** `string` *required*

Идентификатор локации (UUID). Используй `id` из [Списка локаций](https://docs.anivahealth.com/ru/api/locations/list-locations.md).

## Параметры запроса

**start\_date** `string`

Начало интервала включительно в формате `YYYY-MM-DD` (интерпретируется в `timezone`). Необязательно.
По умолчанию — **сегодня**, если не передана ни одна из дат, или **`end_date − 30 days`**, если
передан только `end_date`. Прошедшие даты автоматически сдвигаются к сегодняшнему дню.

**end\_date** `string`

Конец интервала включительно в формате `YYYY-MM-DD` (интерпретируется в `timezone`). Необязательно.
По умолчанию — **сегодня + 30 дней**, если не передана ни одна из дат, или **`start_date + 30 days`**,
если передан только `start_date`. Дата должна быть не раньше `start_date` и в пределах 90 дней от сегодняшнего дня.

**timezone** `string`

Часовой пояс IANA (например, `Europe/Berlin`), используемый для интерпретации `start_date` / `end_date`
и группировки слотов по календарным датам. Необязательно — по умолчанию используется собственный часовой
пояс локации. Время начала слотов всегда возвращается в формате UTC (`Z`) и никогда не смещается от этого
параметра — сетка слотов всегда строится в часовом поясе самой локации; параметр влияет только на то,
к какому календарному дню относится слот. Элементы по дням в ответе точно покрывают диапазон
`start_date`..`end_date` как календарные дни в этом часовом поясе. Не передавай его, если не
отображаешь выбор слотов в другом часовом поясе.

## Ответ

В случае успеха API возвращает `200 OK` с одним объектом доступности.

**location\_id** `string` *required*

Переданный идентификатор локации.

**timezone** `string` *required*

Часовой пояс IANA, в котором сформирован ответ (например, `Europe/Berlin`) — повторяет query-параметр
`timezone`, если он был передан, иначе используется собственный часовой пояс локации.

**slot\_interval\_minutes** `integer`

Интервал между соседними доступными временами начала слотов в минутах. Шаг сетки, настроенный
для локации — каждый слот в `availability` попадает на эту сетку. Равно `null`, только если
для локации не настроено расписание. **Не является длительностью записи:** пересекающиеся записи
с разным временем начала не конфликтуют; при расчёте одновременной загрузки учитываются только
совпадения точного времени начала.

**availability** `array` *required*

Доступные для записи слоты по дням. Дни без доступных слотов не включаются, чтобы ответ оставался
компактным. Каждый элемент содержит:

**элемент за день**

**date** `string` *required*

Календарная дата в часовом поясе ответа `timezone` (`YYYY-MM-DD`).

**slots** `array` *required*

Время начала слотов в UTC (ISO 8601 с суффиксом `Z`) по возрастанию.

## Ответы с ошибками

| Статус | Описание |
| - | - |
| `400` | Неверный ID локации, неверный формат даты или часового пояса, `end_date` раньше `start_date`, либо `end_date` более чем на 90 дней в будущем. |
| `403` | Доступ запрещён — отсутствует scope `appointments_schedule` или локация находится вне твоего контекста доступа. |
| `404` | Локация не найдена или неактивна. |
| `500` | Внутренняя ошибка сервера. |

```bash cURL theme={null}
curl --request GET \
  --url 'https://anivahealth.com/api/v1/locations/b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b/availability?start_date=2026-05-01&end_date=2026-05-07' \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
  "timezone": "Europe/Berlin",
  "slot_interval_minutes": 15,
  "availability": [
    {
      "date": "2026-05-04",
      "slots": ["2026-05-04T07:00:00Z", "2026-05-04T07:15:00Z", "2026-05-04T07:30:00Z"]
    },
    {
      "date": "2026-05-05",
      "slots": ["2026-05-05T06:00:00Z", "2026-05-05T06:15:00Z"]
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.