Naar hoofdinhoud gaan
GET
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.
Gebruik dit endpoint in plaats van beschikbaarheid af te leiden uit de statische open_hours uit Locaties ophalen — alleen dit endpoint houdt rekening met actuele boekingen, uitzonderingen per datum en de 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

string
vereist
Locatie-identifier (UUID). Gebruik de id uit Locaties ophalen.

Queryparameters

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.
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.
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.
string
vereist
Teruggegeven locatie-identifier.
string
vereist
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.
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.
array
vereist
Boekbare tijdsloten per dag. Dagen zonder boekbare tijdsloten worden weggelaten om de payload compact te houden. Elk item bevat:

Foutresponsen