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

# Beschikbaarheid ophalen

> Boekbare starttijden ophalen voor één locatie

Geeft de boekbare starttijden van tijdsloten voor één locatie binnen de gevraagde periode terug. Tijdsloten worden
gegenereerd op basis van `open_hours` van de locatie, waarbij algemene en locatiespecifieke geblokkeerde data worden overgeslagen en
reeds geboekte Aniva-afspraken worden afgetrokken, zodat het resultaat weerspiegelt wat je patiënten
daadwerkelijk aan de clientzijde kunnen reserveren.

Vereist de scope `appointments_schedule`. De locatie moet ook binnen de toegangscontext van de locatiegroep van je API-sleutel vallen.

> [!NOTE]
>
> Gebruik dit endpoint in plaats van beschikbaarheid af te leiden uit de statische `open_hours` uit
> [Locaties ophalen](https://docs.anivahealth.com/nl/api/locations/list-locations.md) — alleen dit endpoint houdt rekening met actuele
> boekingen, uitzonderingen per datum en de [minimale
> boekingstermijn](https://docs.anivahealth.com/nl/api/appointments/create-appointment.md#minimale-boekingstermijn) van 12 uur bij door Aniva
> beheerde locaties. Elk tijdslot dat hier wordt teruggegeven is direct boekbaar.

Antwoorden bevatten `Cache-Control: private, max-age=30, stale-while-revalidate=60`, waardoor een browser
een gecachete payload tot \~30 seconden kan tonen — een tijdslot dat binnen dat venster wordt geboekt,
kan tot de volgende vernieuwing nog boekbaar lijken. Toon conflicten ook bij het boeken.

## Padparameters

**id** `string` *required*

Locatie-identifier (UUID). Gebruik de `id` uit [Locaties ophalen](https://docs.anivahealth.com/nl/api/locations/list-locations.md).

## Queryparameters

**start\_date** `string`

Inclusieve startdatum van de periode in `YYYY-MM-DD` (geïnterpreteerd in `timezone`). Optioneel. Standaard
**vandaag** wanneer geen van beide data wordt meegegeven, of **`end_date − 30 days`** wanneer alleen `end_date`
wordt meegegeven. Data in het verleden worden stilzwijgend aangepast naar vandaag.

**end\_date** `string`

Inclusieve einddatum van de periode in `YYYY-MM-DD` (geïnterpreteerd in `timezone`). Optioneel. Standaard
**vandaag + 30 dagen** wanneer geen van beide data wordt meegegeven, of **`start_date + 30 days`** wanneer alleen
`start_date` wordt meegegeven. Moet op of na `start_date` liggen en binnen 90 dagen vanaf vandaag vallen.

**timezone** `string`

IANA-tijdzone (bijv. `Europe/Berlin`) waarmee `start_date` / `end_date` worden geïnterpreteerd en
tijdsloten per kalenderdag worden gegroepeerd. Optioneel — standaard de eigen tijdzone van de locatie.
De starttijden van tijdsloten zelf worden altijd weergegeven als UTC-tijdstippen (`Z`) en verschuiven nooit
met deze parameter — het tijdslotraster wordt altijd geprojecteerd vanuit de eigen tijdzone van de locatie;
de parameter bepaalt alleen onder welke kalenderdag een tijdslot wordt gegroepeerd. Dagitems in het antwoord
bestrijken precies `start_date`..`end_date` als kalenderdagen in deze tijdzone. Laat deze parameter weg,
tenzij je de kiezer in een andere tijdzone weergeeft.

## Respons

Bij succes geeft de API `200 OK` terug met één beschikbaarheidsobject.

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

Teruggegeven locatie-identifier.

**timezone** `string` *required*

IANA-tijdzone waarin het antwoord wordt weergegeven (bijv. `Europe/Berlin`) — geeft de queryparameter
`timezone` terug wanneer die is meegegeven, anders de eigen tijdzone van de locatie.

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

Tussenruimte in minuten tussen opeenvolgende boekbare starttijden. De voor de locatie ingestelde
rasterstap — elk tijdslot in `availability` valt op dit raster. Alleen `null` wanneer de locatie
geen planningsconfiguratie heeft. **Geen afspraakduur:** overlappende boekingen met verschillende
starttijden conflicteren niet; alleen exact gelijke starttijden tellen mee voor gelijktijdigheid.

**availability** `array` *required*

Boekbare tijdsloten per dag. Dagen zonder boekbare tijdsloten worden weggelaten om de payload
compact te houden. Elk item bevat:

**item per dag**

**date** `string` *required*

Kalenderdatum in de `timezone` van het antwoord (`YYYY-MM-DD`).

**slots** `array` *required*

Starttijden van tijdsloten als UTC-tijdstippen (ISO 8601 met `Z`-achtervoegsel), oplopend gesorteerd.

## Foutresponsen

| Status | Beschrijving |
| - | - |
| `400` | Ongeldige locatie-ID, ongeldige datum- of tijdzone-indeling, `end_date` vóór `start_date`, of `end_date` meer dan 90 dagen in de toekomst. |
| `403` | Geen toegang — de scope `appointments_schedule` ontbreekt of de locatie valt buiten je toegangscontext. |
| `404` | Locatie niet gevonden of inactief. |
| `500` | Interne serverfout. |

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