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

# Hämta tillgänglighet

> Hämta bokningsbara starttider för en enskild plats

Returnerar bokningsbara starttider för en enskild plats inom det begärda tidsfönstret. Tiderna
genereras från platsens `open_hours`, där globala och platsspecifika spärrade datum hoppas över
och redan bokade Aniva-bokningar räknas bort, så att resultatet motsvarar vad dina patienter
faktiskt kan boka på klientsidan.

Kräver scopet `appointments_schedule`. Platsen måste också ingå i din API-nyckels åtkomstkontext för platsgrupper.

> [!NOTE]
>
> Använd den här endpointen i stället för att härleda tillgänglighet från statiska `open_hours` som
> returneras av [Lista platser](https://docs.anivahealth.com/sv/api/locations/list-locations.md) — bara den här endpointen tar hänsyn
> till aktuella bokningar, datumspecifika schemaundantag och 12-timmarsgränsen för
> [minsta framförhållning](https://docs.anivahealth.com/sv/api/appointments/create-appointment.md#minsta-framfoerhallning) på platser som drivs
> av Aniva. Varje tid som returneras här går att boka direkt.

Svar har `Cache-Control: private, max-age=30, stale-while-revalidate=60`, så en webbläsare kan
visa ett cachat svar i upp till ca 30 sekunder — en tid som bokas inom det fönstret kan
fortfarande visas som bokningsbar fram till nästa uppdatering. Hantera konflikter även vid
bokningstillfället.

## Sökvägsparametrar

**id** `string` *required*

Platsidentifierare (UUID). Använd `id` från [Lista platser](https://docs.anivahealth.com/sv/api/locations/list-locations.md).

## Frågeparametrar

**start\_date** `string`

Inkluderande startdatum för fönstret i formatet `YYYY-MM-DD` (tolkas i `timezone`). Valfritt.
Standardvärdet är **idag** när inget datum anges, eller **`end_date − 30 days`** när bara
`end_date` anges. Förflutna datum justeras tyst till idag.

**end\_date** `string`

Inkluderande slutdatum för fönstret i formatet `YYYY-MM-DD` (tolkas i `timezone`). Valfritt.
Standardvärdet är **idag + 30 dagar** när inget datum anges, eller **`start_date + 30 days`** när
bara `start_date` anges. Måste vara på eller efter `start_date` och inom 90 dagar från idag.

**timezone** `string`

IANA-tidszon (t.ex. `Europe/Berlin`) som används för att tolka `start_date` / `end_date` och
gruppera tider efter kalenderdatum. Valfritt — använder annars platsens egen tidszon. Själva
starttiderna returneras alltid som UTC-tidpunkter (`Z`) och flyttas aldrig av den här
parametern — tidsrutnätet utgår alltid från platsens egen tidszon; parametern styr bara vilken
kalenderdag en tid grupperas under. Dagposterna i svaret täcker exakt `start_date`..`end_date`
som kalenderdagar i den här tidszonen. Utelämna parametern om du inte visar tidsväljaren i en
annan tidszon.

## Svar

Vid framgång returnerar API:et `200 OK` med ett enda tillgänglighetsobjekt.

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

Återgiven platsidentifierare.

**timezone** `string` *required*

IANA-tidszon som svaret visas i (t.ex. `Europe/Berlin`) — återger frågeparametern `timezone` när
den anges, annars platsens egen tidszon.

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

Avstånd i minuter mellan på varandra följande bokningsbara starttider. Platsens konfigurerade
tidsintervall — varje tid i `availability` hamnar på det här intervallet. `null` bara när platsen
saknar schemakonfiguration. **Inte längden på en bokning:** överlappande bokningar med olika
starttider står inte i konflikt med varandra; bara krockar med exakt samma starttid räknas mot
samtidiga bokningar.

**availability** `array` *required*

Bokningsbara tider per dag. Dagar utan bokningsbara tider utelämnas för att hålla svaret litet.
Varje post har:

**post per dag**

**date** `string` *required*

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

**slots** `array` *required*

Starttider som UTC-tidpunkter (ISO 8601 med `Z`-suffix), sorterade stigande.

## Felsvar

| Status | Beskrivning |
| - | - |
| `400` | Ogiltigt plats-ID, ogiltigt datum- eller tidszonsformat, `end_date` före `start_date` eller `end_date` mer än 90 dagar framåt i tiden. |
| `403` | Åtkomst nekad — saknar scopet `appointments_schedule` eller så ligger platsen utanför din åtkomstkontext. |
| `404` | Platsen hittades inte eller är inaktiv. |
| `500` | Internt serverfel. |

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