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

> Hent bestillbare starttidspunkter for ett enkelt sted

Returnerer bestillbare starttidspunkter for ett enkelt sted i det forespurte tidsrommet.
Tidsluker genereres fra stedets `open_hours`, der globale / stedsspesifikke sperrede datoer
hoppes over og allerede bestilte Aniva-timer trekkes fra, slik at resultatet gjenspeiler det
pasientene dine faktisk kan reservere på klientsiden.

Krever scopet `appointments_schedule`. Stedet må også være innenfor tilgangskonteksten for stedsgruppen til API-nøkkelen din.

> [!NOTE]
>
> Bruk dette endepunktet i stedet for å utlede tilgjengelighet fra de statiske `open_hours` som
> returneres av [Vis steder](https://docs.anivahealth.com/no/api/locations/list-locations.md) — bare dette endepunktet tar hensyn
> til løpende bestillinger, datospesifikke unntak i tidsplanen og 12-timers
> [minstefrist](https://docs.anivahealth.com/no/api/appointments/create-appointment.md#minimumsfrist) ved steder drevet av Aniva.
> Hver tidsluke som returneres her kan bestilles direkte.

Svar inneholder `Cache-Control: private, max-age=30, stale-while-revalidate=60`, så en nettleser
kan levere et hurtigbufret svar i opptil \~30 sekunder — en tidsluke som bestilles i dette
vinduet kan fortsatt se bestillbar ut frem til neste oppdatering. Vis også konflikter ved
bestilling.

## Stiparametere

**id** `string` *required*

Stedsidentifikator (UUID). Bruk `id` fra [Vis steder](https://docs.anivahealth.com/no/api/locations/list-locations.md).

## Spørreparametere

**start\_date** `string`

Inklusiv start på tidsrommet i `YYYY-MM-DD` (tolket i `timezone`). Valgfri. Standard er **i
dag** når ingen dato oppgis, eller **`end_date − 30 days`** når bare `end_date` oppgis. Datoer
i fortiden justeres uten varsel til i dag.

**end\_date** `string`

Inklusiv slutt på tidsrommet i `YYYY-MM-DD` (tolket i `timezone`). Valgfri. Standard er
**i dag + 30 dager** når ingen av datoene oppgis, eller **`start_date + 30 days`** når bare
`start_date` oppgis. Må være på eller etter `start_date` og innen 90 dager fra i dag.

**timezone** `string`

IANA-tidssone (f.eks. `Europe/Berlin`) som brukes til å tolke `start_date` / `end_date` og til å
gruppere tidsluker etter kalenderdato. Valgfri — bruker stedets egen tidssone som standard.
Starttidspunktene for tidsluker returneres alltid som UTC-tidspunkter (`Z`) og endres aldri med
denne parameteren — rutenettet for tidsluker projiseres alltid fra stedets egen tidssone;
parameteren påvirker bare hvilken kalenderdag en tidsluke grupperes under. Dagspostene i svaret
dekker nøyaktig `start_date`..`end_date` som kalenderdager i denne tidssonen. Utelat den med
mindre du viser velgeren i en annen tidssone.

## Respons

Ved suksess returnerer API-et `200 OK` med ett enkelt tilgjengelighetsobjekt.

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

Gjentatt stedsidentifikator.

**timezone** `string` *required*

IANA-tidssonen svaret gjengis i (f.eks. `Europe/Berlin`) — gjentar spørringsparameteren
`timezone` når den er oppgitt, ellers stedets egen tidssone.

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

Avstand mellom påfølgende bestillbare starttidspunkter i minutter. Det stedskonfigurerte
rutenettsteget — hver tidsluke i `availability` følger dette rutenettet. `null` bare når stedet
ikke har noen tidsplankonfigurasjon. **Ikke et varighetsvindu for timen:** Overlappende
bestillinger med ulike starttidspunkter er ikke i konflikt; bare nøyaktig samme starttidspunkt
teller mot samtidighet.

**availability** `array` *required*

Bestillbare tidsluker per dag. Dager uten bestillbare tidsluker utelates for å holde svaret
kompakt. Hvert element har:

**element per dag**

**date** `string` *required*

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

**slots** `array` *required*

Starttidspunkter for tidsluker som UTC-tidspunkter (ISO 8601 med `Z`-suffiks), sortert stigende.

## Feilresponser

| Status | Beskrivelse |
| - | - |
| `400` | Ugyldig steds-ID, ugyldig dato- eller tidssoneformat, `end_date` før `start_date`, eller `end_date` mer enn 90 dager frem i tid. |
| `403` | Forbudt — mangler scopet `appointments_schedule`, eller stedet er utenfor tilgangskonteksten din. |
| `404` | Stedet ble ikke funnet eller er inaktivt. |
| `500` | Intern serverfeil. |

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