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

# Verfügbarkeit abrufen

> Buchbare Startzeiten für einen einzelnen Standort abrufen

Gibt die buchbaren Slot-Startzeiten für einen einzelnen Standort im angefragten Zeitraum zurück. Slots
werden aus den `open_hours` des Standorts erzeugt, wobei globale und standortspezifische Sperrtage
übersprungen und bereits gebuchte Aniva-Termine abgezogen werden, sodass das Ergebnis widerspiegelt,
was deine Patienten clientseitig tatsächlich reservieren können.

Erfordert den Scope `appointments_schedule`. Der Standort muss außerdem im Standortgruppen-Zugriffskontext deines API-Schlüssels liegen.

> [!NOTE]
>
> Nutze diesen Endpunkt, statt die Verfügbarkeit aus den statischen `open_hours` von [Standorte
> auflisten](https://docs.anivahealth.com/de/api/locations/list-locations.md) abzuleiten – nur dieser Endpunkt berücksichtigt Live-Buchungen,
> tagesbezogene Ausnahmen im Zeitplan und die 12-stündige
> [Mindestvorlaufzeit](https://docs.anivahealth.com/de/api/appointments/create-appointment.md#mindestvorlaufzeit) an von Aniva betriebenen
> Standorten. Jeder hier zurückgegebene Slot ist direkt so buchbar.

Antworten enthalten `Cache-Control: private, max-age=30, stale-while-revalidate=60`, sodass ein Browser
eine zwischengespeicherte Antwort bis zu ca. 30 Sekunden lang ausliefern kann – ein in diesem Zeitfenster
gebuchter Slot kann bis zur nächsten Aktualisierung noch als buchbar erscheinen. Zeige Konflikte auch
bei der Buchung an.

## Pfadparameter

**id** `string` *required*

Standortkennung (UUID). Verwende die `id` aus [Standorte auflisten](https://docs.anivahealth.com/de/api/locations/list-locations.md).

## Query-Parameter

**start\_date** `string`

Inklusiver Beginn des Zeitraums im Format `YYYY-MM-DD` (interpretiert in `timezone`). Optional.
Standardmäßig **heute**, wenn kein Datum angegeben wird, oder **`end_date − 30 days`**, wenn nur
`end_date` angegeben wird. Daten in der Vergangenheit werden stillschweigend auf heute begrenzt.

**end\_date** `string`

Inklusives Ende des Zeitraums im Format `YYYY-MM-DD` (interpretiert in `timezone`). Optional.
Standardmäßig **heute + 30 Tage**, wenn kein Datum angegeben wird, oder **`start_date + 30 days`**, wenn
nur `start_date` angegeben wird. Muss am oder nach `start_date` und innerhalb von 90 Tagen ab heute
liegen.

**timezone** `string`

IANA-Zeitzone (z. B. `Europe/Berlin`), die zur Interpretation von `start_date` / `end_date` und zur
Gruppierung von Slots nach Kalendertag dient. Optional – standardmäßig die Zeitzone des Standorts.
Die Slot-Startzeiten selbst werden immer als UTC-Zeitpunkte (`Z`) ausgegeben und verschieben sich mit
diesem Parameter nicht – das Slot-Raster richtet sich immer nach der Zeitzone des Standorts; der
Parameter beeinflusst nur, welchem Kalendertag ein Slot zugeordnet wird. Die Tageseinträge in der
Antwort decken genau `start_date`..`end_date` als Kalendertage in dieser Zeitzone ab. Lass ihn weg,
sofern du die Auswahl nicht in einer anderen Zeitzone anzeigst.

## Antwort

Bei Erfolg gibt die API `200 OK` mit einem einzelnen Verfügbarkeitsobjekt zurück.

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

Übernommene Standortkennung.

**timezone** `string` *required*

IANA-Zeitzone, in der die Antwort ausgegeben wird (z. B. `Europe/Berlin`) – übernimmt den
Query-Parameter `timezone`, falls angegeben, sonst die Zeitzone des Standorts.

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

Abstand zwischen aufeinanderfolgenden buchbaren Slot-Startzeiten in Minuten. Der für den Standort
konfigurierte Rasterschritt – jeder Slot in `availability` liegt auf diesem Raster. Nur `null`, wenn
der Standort keine Terminplanungs-Konfiguration hat. **Kein Zeitfenster für die Termindauer:**
Überschneidende Buchungen mit unterschiedlichen Startzeiten stehen nicht im Konflikt; nur exakte
Startzeit-Kollisionen zählen für die Parallelität.

**availability** `array` *required*

Buchbare Slots pro Tag. Tage ohne buchbare Slots werden ausgelassen, um die Antwort kompakt zu
halten. Jeder Eintrag enthält:

**Tageseintrag**

**date** `string` *required*

Kalenderdatum in der `timezone` der Antwort (`YYYY-MM-DD`).

**slots** `array` *required*

Slot-Startzeiten als UTC-Zeitpunkte (ISO 8601 mit `Z`-Suffix), aufsteigend sortiert.

## Fehlerantworten

| Status | Beschreibung |
| - | - |
| `400` | Ungültige Standort-ID, ungültiges Datums- oder Zeitzonenformat, `end_date` liegt vor `start_date` oder `end_date` liegt mehr als 90 Tage in der Zukunft. |
| `403` | Zugriff verweigert – der Scope `appointments_schedule` fehlt oder der Standort liegt außerhalb deines Zugriffskontexts. |
| `404` | Standort nicht gefunden oder inaktiv. |
| `500` | Interner Serverfehler. |

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