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

# Elérhetőség lekérése

> Kérd le egy adott helyszín foglalható idősávjainak kezdőidőpontjait

Visszaadja egy adott helyszín foglalható idősávjainak kezdési időpontjait a kért időablakban. Az
idősávokat a helyszín `open_hours` adatai alapján generáljuk, kihagyva a globális és helyszínszintű
zárolt dátumokat, valamint levonva a már lefoglalt Aniva-időpontokat, így az eredmény pontosan azt
mutatja, amit a pácienseid kliensoldalon valóban le tudnak foglalni.

Az `appointments_schedule` scope szükséges hozzá. A helyszínnek az API-kulcsod helyszíncsoport-hozzáférési körébe is bele kell esnie.

> [!NOTE]
>
> Ahelyett, hogy a [Helyszínek listázása](https://docs.anivahealth.com/hu/api/locations/list-locations.md) végpont által visszaadott
> statikus `open_hours` adatokból következtetnél az elérhetőségre, használd ezt a végpontot – csak
> ez veszi figyelembe az élő foglalásokat, a dátumonkénti nyitvatartási kivételeket, valamint az
> Aniva által üzemeltetett helyszíneken érvényes 12 órás
> [minimális előzetes értesítési időt](https://docs.anivahealth.com/hu/api/appointments/create-appointment.md#minimalis-elofoglalasi-ido). Minden
> itt visszaadott idősáv közvetlenül foglalható.

A válaszok `Cache-Control: private, max-age=30, stale-while-revalidate=60` fejlécet tartalmaznak,
így a böngésző akár \~30 másodpercig gyorsítótárazott választ is kiszolgálhat – egy ezen az ablakon
belül lefoglalt idősáv a következő frissítésig még foglalhatónak tűnhet. A foglaláskor fellépő
ütközéseket is jelenítsd meg.

## Útvonalparaméterek

**id** `string` *required*

Helyszínazonosító (UUID). Használd a [Helyszínek listázása](https://docs.anivahealth.com/hu/api/locations/list-locations.md) végpontból kapott `id` értéket.

## Lekérdezési paraméterek

**start\_date** `string`

Az időablak kezdő dátuma (beleértve) `YYYY-MM-DD` formátumban (a `timezone` alapján értelmezve).
Opcionális. Alapértelmezett értéke a **mai nap**, ha egyik dátum sincs megadva, vagy
**`end_date − 30 days`**, ha csak az `end_date` van megadva. A múltbeli dátumokat a rendszer
csendben a mai napra korlátozza.

**end\_date** `string`

Az időablak záró dátuma (beleértve) `YYYY-MM-DD` formátumban (a `timezone` alapján értelmezve).
Opcionális. Alapértelmezett értéke **ma + 30 nap**, ha egyik dátum sincs megadva, vagy
**`start_date + 30 days`**, ha csak a `start_date` van megadva. A `start_date` dátummal megegyező
vagy annál későbbi, és a mai naptól számított 90 napon belüli dátumnak kell lennie.

**timezone** `string`

IANA időzóna (pl. `Europe/Berlin`), amely a `start_date` / `end_date` értelmezésére és az
idősávok naptári nap szerinti csoportosítására szolgál. Opcionális – alapértelmezetten a helyszín
saját időzónája. Maguk az idősávok kezdési időpontjai mindig UTC időpontként (`Z`) jelennek meg,
és nem változnak ezzel a paraméterrel – az idősávrács mindig a helyszín saját időzónájából
származik; a paraméter csak azt befolyásolja, hogy egy idősáv melyik naptári nap alá kerül. A
válaszban szereplő napi bejegyzések pontosan a `start_date`..`end_date` tartományt fedik le
naptári napként ebben az időzónában. Hagyd el, hacsak nem másik időzónában jeleníted meg az
időpontválasztót.

## Válasz

Sikeres kérés esetén az API `200 OK` választ ad vissza egyetlen elérhetőségi objektummal.

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

A visszaküldött helyszínazonosító.

**timezone** `string` *required*

Az IANA időzóna, amelyben a válasz megjelenik (pl. `Europe/Berlin`) – ha megadtad a `timezone`
lekérdezési paramétert, azt adja vissza, egyébként a helyszín saját időzónáját.

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

Az egymást követő foglalható idősávok kezdete közötti távolság percben. A helyszínnél beállított
rácslépésköz – az `availability` minden idősávja erre a rácsra esik. Csak akkor `null`, ha a
helyszínhez nincs időpont-beosztási beállítás. **Nem az időpont időtartamát jelöli:** a különböző
kezdési idejű, egymást átfedő foglalások nem ütköznek; csak a pontosan azonos kezdésű ütközések
számítanak az egyidejűségbe.

**availability** `array` *required*

Napi bontású foglalható idősávok. Azokat a napokat, amelyeken nincs foglalható idősáv, kihagyjuk,
hogy a válasz tömör maradjon. Minden bejegyzés a következőket tartalmazza:

**napi bejegyzés**

**date** `string` *required*

Naptári dátum a válasz `timezone` időzónájában (`YYYY-MM-DD`).

**slots** `array` *required*

Az idősávok kezdési időpontjai UTC időpontként (ISO 8601 formátumban, `Z` végződéssel), növekvő sorrendben.

## Hibaválaszok

| Státusz | Leírás |
| - | - |
| `400` | Érvénytelen helyszínazonosító, érvénytelen dátum- vagy időzóna-formátum, az `end_date` korábbi, mint a `start_date`, vagy az `end_date` több mint 90 nappal a jövőben van. |
| `403` | Tiltott – hiányzik az `appointments_schedule` scope, vagy a helyszín kívül esik a hozzáférési körödön. |
| `404` | A helyszín nem található vagy inaktív. |
| `500` | Belső szerverhiba. |

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