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

# Hent ledige tider

> Hent ledige starttidspunkter for en enkelt lokation

Returnerer de bookbare starttidspunkter for en enkelt lokation i det ønskede tidsrum. Tidsslots
genereres ud fra lokationens `open_hours`, hvor globale og lokationsspecifikke blokerede datoer
springes over, og allerede bookede Aniva-tider trækkes fra, så resultatet afspejler det, dine
patienter faktisk kan reservere på klientsiden.

Kræver scopet `appointments_schedule`. Lokationen skal også være omfattet af din API-nøgles adgangskontekst for lokationsgrupper.

> [!NOTE]
>
> Brug dette endpoint i stedet for at udlede ledighed fra de statiske `open_hours`, som returneres af
> [Vis lokationer](https://docs.anivahealth.com/da/api/locations/list-locations.md) — kun dette endpoint tager højde for aktuelle
> bookinger, datospecifikke undtagelser og [minimumsvarslet](https://docs.anivahealth.com/da/api/appointments/create-appointment.md#minimumsvarsel)
> på 12 timer på lokationer drevet af Aniva. Hvert tidsslot, der returneres her, kan bookes direkte.

Svar indeholder `Cache-Control: private, max-age=30, stale-while-revalidate=60`, så en browser kan
levere et cachet svar i op til \~30 sekunder — et tidsslot, der bookes inden for det vindue, kan
stadig se bookbart ud indtil næste opdatering. Vis også konflikter ved booking.

## Path-parametre

**id** `string` *required*

Lokations-id (UUID). Brug det `id`, du får fra [Vis lokationer](https://docs.anivahealth.com/da/api/locations/list-locations.md).

## Query-parametre

**start\_date** `string`

Inklusiv start på tidsrummet i `YYYY-MM-DD` (fortolket i `timezone`). Valgfri. Standard er **i dag**,
når ingen af datoerne angives, eller **`end_date − 30 days`**, når kun `end_date` angives. Datoer
i fortiden sættes automatisk til i dag.

**end\_date** `string`

Inklusiv slutning på tidsrummet i `YYYY-MM-DD` (fortolket i `timezone`). Valgfri. Standard er
**i dag + 30 dage**, når ingen af datoerne angives, eller **`start_date + 30 days`**, når kun
`start_date` angives. Skal ligge på eller efter `start_date` og inden for 90 dage fra i dag.

**timezone** `string`

IANA-tidszone (f.eks. `Europe/Berlin`), som bruges til at fortolke `start_date` / `end_date` og
gruppere tidsslots efter kalenderdato. Valgfri — standard er lokationens egen tidszone. Selve
starttidspunkterne vises altid som UTC-tidspunkter (`Z`) og ændrer sig aldrig med denne parameter
— tidsslot-nettet beregnes altid ud fra lokationens egen tidszone; parameteren påvirker kun,
hvilken kalenderdag et tidsslot grupperes under. Dagsposterne i svaret dækker præcis
`start_date`..`end_date` som kalenderdage i denne tidszone. Udelad den, medmindre du viser
tidsvælgeren i en anden tidszone.

## Svar

Ved succes returnerer API'et `200 OK` med et enkelt ledighedsobjekt.

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

Gentaget lokations-id.

**timezone** `string` *required*

IANA-tidszonen, som svaret vises i (f.eks. `Europe/Berlin`) — gentager query-parameteren `timezone`,
hvis den er angivet, ellers lokationens egen tidszone.

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

Afstanden i minutter mellem på hinanden følgende bookbare starttidspunkter. Lokationens
konfigurerede interval — hvert tidsslot i `availability` følger dette net. Kun `null`, når
lokationen ikke har nogen tidsplanskonfiguration. **Ikke et varighedsvindue for tiden:**
overlappende bookinger med forskellige starttidspunkter giver ikke konflikt; kun sammenfald med
præcis samme starttidspunkt tæller med i samtidigheden.

**availability** `array` *required*

Bookbare tidsslots pr. dag. Dage uden bookbare tidsslots udelades for at holde svaret kompakt.
Hver post indeholder:

**dagspost**

**date** `string` *required*

Kalenderdato i svarets `timezone` (`YYYY-MM-DD`).

**slots** `array` *required*

Starttidspunkter som UTC-tidspunkter (ISO 8601 med `Z`-suffiks) i stigende rækkefølge.

## Fejlsvar

| Status | Beskrivelse |
| - | - |
| `400` | Ugyldigt lokations-id, ugyldigt dato- eller tidszoneformat, `end_date` før `start_date` eller `end_date` mere end 90 dage ude i fremtiden. |
| `403` | Forbudt — mangler scopet `appointments_schedule`, eller lokationen ligger uden for din adgangskontekst. |
| `404` | Lokation ikke fundet eller inaktiv. |
| `500` | Intern serverfejl. |

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