> ## 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.

# Pobierz dostępność

> Pobierz godziny rozpoczęcia dostępnych terminów w jednej lokalizacji

Zwraca dostępne godziny rozpoczęcia terminów dla jednej lokalizacji w podanym przedziale. Terminy są
generowane na podstawie `open_hours` lokalizacji, z pominięciem globalnych i lokalnych zablokowanych dat
oraz po odjęciu już zarezerwowanych wizyt Aniva, dzięki czemu wynik odzwierciedla to, co twoi pacjenci
faktycznie mogą zarezerwować po stronie klienta.

Wymaga zakresu `appointments_schedule`. Lokalizacja musi też mieścić się w kontekście dostępu grupy lokalizacji twojego klucza API.

> [!NOTE]
>
> Używaj tego endpointu zamiast wnioskować o dostępności ze statycznego pola `open_hours` zwracanego
> przez [Lista lokalizacji](https://docs.anivahealth.com/pl/api/locations/list-locations.md) — tylko ten endpoint uwzględnia bieżące
> rezerwacje, wyjątki w harmonogramie dla konkretnych dat oraz 12-godzinne [minimalne
> wyprzedzenie](https://docs.anivahealth.com/pl/api/appointments/create-appointment.md#minimalne-wyprzedzenie) w lokalizacjach prowadzonych
> przez Aniva. Każdy zwrócony tutaj termin można od razu zarezerwować.

Odpowiedzi zawierają nagłówek `Cache-Control: private, max-age=30, stale-while-revalidate=60`, więc
przeglądarka może serwować dane z pamięci podręcznej przez maksymalnie ok. 30 sekund — termin
zarezerwowany w tym oknie może nadal wyglądać na dostępny do następnego odświeżenia. Wyświetlaj
konflikty również w momencie rezerwacji.

## Parametry ścieżki

**id** `string` *required*

Identyfikator lokalizacji (UUID). Użyj `id` z [Lista lokalizacji](https://docs.anivahealth.com/pl/api/locations/list-locations.md).

## Parametry zapytania

**start\_date** `string`

Początek przedziału (włącznie) w formacie `YYYY-MM-DD` (interpretowany w `timezone`). Opcjonalne.
Domyślnie **dzisiaj**, gdy nie podano żadnej daty, albo **`end_date − 30 days`**, gdy podano tylko
`end_date`. Daty z przeszłości są automatycznie przycinane do dzisiejszej daty.

**end\_date** `string`

Koniec przedziału (włącznie) w formacie `YYYY-MM-DD` (interpretowany w `timezone`). Opcjonalne.
Domyślnie **dzisiaj + 30 dni**, gdy nie podano żadnej daty, albo **`start_date + 30 days`**, gdy
podano tylko `start_date`. Musi przypadać nie wcześniej niż `start_date` i w ciągu 90 dni od
dzisiaj.

**timezone** `string`

Strefa czasowa IANA (np. `Europe/Berlin`) używana do interpretacji `start_date` / `end_date` oraz
grupowania terminów według daty kalendarzowej. Opcjonalne — domyślnie używana jest strefa czasowa
samej lokalizacji. Same godziny rozpoczęcia terminów są zawsze zwracane jako znaczniki UTC (`Z`) i
nigdy nie przesuwają się pod wpływem tego parametru — siatka terminów jest zawsze wyznaczana w
strefie czasowej lokalizacji; parametr wpływa wyłącznie na to, do którego dnia kalendarzowego
zostanie przypisany termin. Wpisy dzienne w odpowiedzi obejmują dokładnie `start_date`..`end_date`
jako dni kalendarzowe w tej strefie czasowej. Pomiń ten parametr, chyba że wyświetlasz wybór
terminu w innej strefie czasowej.

## Odpowiedź

W przypadku powodzenia API zwraca `200 OK` z pojedynczym obiektem dostępności.

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

Zwrócony identyfikator lokalizacji.

**timezone** `string` *required*

Strefa czasowa IANA, w której zwracana jest odpowiedź (np. `Europe/Berlin`) — powtarza parametr
zapytania `timezone`, jeśli go podano, a w przeciwnym razie strefę czasową samej lokalizacji.

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

Odstęp w minutach między kolejnymi dostępnymi godzinami rozpoczęcia terminów. Krok siatki
skonfigurowany dla lokalizacji — każdy termin w `availability` wypada na tej siatce. `null` tylko
wtedy, gdy lokalizacja nie ma konfiguracji harmonogramu. **Nie jest to czas trwania wizyty:**
nakładające się rezerwacje o różnych godzinach rozpoczęcia nie kolidują ze sobą; do limitu
równoczesnych wizyt liczą się tylko kolizje tej samej godziny rozpoczęcia.

**availability** `array` *required*

Dostępne terminy w podziale na dni. Dni bez dostępnych terminów są pomijane, aby ograniczyć
rozmiar odpowiedzi. Każdy wpis zawiera:

**wpis dzienny**

**date** `string` *required*

Data kalendarzowa w strefie `timezone` odpowiedzi (`YYYY-MM-DD`).

**slots** `array` *required*

Godziny rozpoczęcia terminów jako znaczniki UTC (ISO 8601 z sufiksem `Z`), posortowane rosnąco.

## Odpowiedzi z błędami

| Status | Opis |
| - | - |
| `400` | Nieprawidłowe ID lokalizacji, nieprawidłowy format daty lub strefy czasowej, `end_date` wcześniejsze niż `start_date` albo `end_date` ponad 90 dni w przyszłości. |
| `403` | Brak dostępu — brak zakresu `appointments_schedule` lub lokalizacja poza twoim kontekstem dostępu. |
| `404` | Nie znaleziono lokalizacji lub jest nieaktywna. |
| `500` | Wewnętrzny błąd serwera. |

```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.