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

# Získat dostupnost

> Načíst začátky volných termínů pro jedno místo

Vrátí začátky volných slotů k rezervaci pro jednu lokalitu v požadovaném období. Sloty se
generují z `open_hours` dané lokality, přičemž se vynechají globálně nebo lokálně blokovaná data a
odečtou už rezervované termíny Aniva, takže výsledek odpovídá tomu, co si tvoji pacienti mohou
na straně klienta skutečně rezervovat.

Vyžaduje scope `appointments_schedule`. Lokalita navíc musí spadat do přístupového kontextu skupiny lokalit tvého API klíče.

> [!NOTE]
>
> Používej tento endpoint místo odvozování dostupnosti ze statického pole `open_hours`, které vrací
> [Seznam lokalit](https://docs.anivahealth.com/cs/api/locations/list-locations.md) – jen tento endpoint zohledňuje aktuální rezervace,
> výjimky v rozvrhu pro konkrétní dny a 12hodinový [minimální
> předstih](https://docs.anivahealth.com/cs/api/appointments/create-appointment.md#minimalni-predstih) v lokalitách provozovaných Aniva.
> Každý slot vrácený tímto endpointem lze rovnou rezervovat.

Odpovědi obsahují `Cache-Control: private, max-age=30, stale-while-revalidate=60`, takže prohlížeč
může vracet data z mezipaměti až zhruba 30 sekund – slot rezervovaný v tomto okně se tak až do
dalšího načtení může dál tvářit jako volný. Konflikty zobrazuj i při samotné rezervaci.

## Parametry cesty

**id** `string` *required*

Identifikátor lokality (UUID). Použij `id` ze [Seznamu lokalit](https://docs.anivahealth.com/cs/api/locations/list-locations.md).

## Parametry dotazu

**start\_date** `string`

Začátek období včetně ve formátu `YYYY-MM-DD` (vyhodnocovaný v `timezone`). Nepovinný. Výchozí
hodnota je **dnešek**, pokud neuvedeš ani jedno datum, nebo **`end_date − 30 days`**, pokud
uvedeš jen `end_date`. Data v minulosti se bez upozornění posunou na dnešek.

**end\_date** `string`

Konec období včetně ve formátu `YYYY-MM-DD` (vyhodnocovaný v `timezone`). Nepovinný. Výchozí
hodnota je **dnešek + 30 dní**, pokud neuvedeš ani jedno datum, nebo **`start_date + 30 days`**,
pokud uvedeš jen `start_date`. Musí být rovné nebo pozdější než `start_date` a nejvýše 90 dní od
dneška.

**timezone** `string`

Časové pásmo IANA (např. `Europe/Berlin`), ve kterém se vyhodnocují `start_date` / `end_date` a
seskupují sloty podle kalendářního data. Nepovinný – výchozí je vlastní časové pásmo lokality.
Samotné časy začátků slotů se vždy vrací v UTC (`Z`) a tímto parametrem se neposouvají – mřížka
slotů vždy vychází z vlastního časového pásma lokality; parametr ovlivňuje jen to, pod jaký
kalendářní den se slot zařadí. Položky dnů v odpovědi pokrývají přesně kalendářní dny
`start_date`..`end_date` v tomto časovém pásmu. Pokud nezobrazuješ výběr termínu v jiném
časovém pásmu, parametr vynech.

## Odpověď

Při úspěchu API vrátí `200 OK` s jedním objektem dostupnosti.

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

Zopakovaný identifikátor lokality.

**timezone** `string` *required*

Časové pásmo IANA, ve kterém je odpověď vrácena (např. `Europe/Berlin`) – opakuje parametr
dotazu `timezone`, pokud byl uveden, jinak vlastní časové pásmo lokality.

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

Rozestup mezi začátky po sobě jdoucích rezervovatelných slotů v minutách. Krok mřížky nastavený
pro lokalitu – každý slot v `availability` spadá do této mřížky. `null` jen v případě, že
lokalita nemá nastavený rozvrh. **Nejde o délku termínu:** překrývající se rezervace s různým
začátkem nekolidují; do souběžnosti se počítají jen přesné shody začátků.

**availability** `array` *required*

Rezervovatelné sloty po jednotlivých dnech. Dny bez volných slotů se vynechávají, aby byla
odpověď co nejmenší. Každá položka obsahuje:

**denní položka**

**date** `string` *required*

Kalendářní datum v `timezone` odpovědi (`YYYY-MM-DD`).

**slots** `array` *required*

Začátky slotů v UTC (ISO 8601 s příponou `Z`), seřazené vzestupně.

## Chybové odpovědi

| Status | Popis |
| - | - |
| `400` | Neplatné ID lokality, neplatný formát data nebo časového pásma, `end_date` před `start_date`, nebo `end_date` více než 90 dní v budoucnosti. |
| `403` | Přístup odepřen – chybí scope `appointments_schedule` nebo lokalita nespadá do tvého přístupového kontextu. |
| `404` | Lokalita nebyla nalezena nebo není aktivní. |
| `500` | Interní chyba serveru. |

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