> ## 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, тож результат відображає те, що твої пацієнти можуть
реально забронювати на клієнтській стороні.

Потрібен дозвіл `appointments_schedule`. Локація також має входити до контексту доступу групи локацій твого API-ключа.

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

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

## Параметри шляху

**id** `string` *required*

Ідентифікатор локації (UUID). Використовуй `id` зі [Списку локацій](https://docs.anivahealth.com/uk/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`) — повторює параметр запиту
`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` | Доступ заборонено — бракує дозволу `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.