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

# Book en tid

> Trin-for-trin-guide: find en testlokation, tjek ledige tider, og book en tid til blodprøvetagning med Anivas API.

Brug denne guide til at finde et teststed, oprette en tid til en patientprofil og tilføje de testpaneler, der skal køres. Gennemfør disse trin, før patienten møder op til sin blodprøvetagning.

**1. Gennemse tilgængelige lokationer**

Hent listen over teststeder, der er tilgængelige på din konto, ved at sende en `GET`-anmodning til `/api/v1/locations`.

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/locations \
  --header 'x-api-key: YOUR_API_KEY'
```

```javascript JavaScript theme={null}
const response = await fetch('https://anivahealth.com/api/v1/locations', {
  headers: {
    'x-api-key': 'YOUR_API_KEY',
  },
});

const locations = await response.json();
```

Svaret er et array af lokationsobjekter:

```json theme={null}
[
  {
    "id": "b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421",
    "name": "Aniva Berlin Mitte",
    "company_name": "Aniva GmbH",
    "street": "Friedrichstraße",
    "house_number": "112",
    "address_line_2": null,
    "city": "Berlin",
    "state": "Berlin",
    "postal_code": "10117",
    "country_name": "Germany",
    "country_code": "DE",
    "timezone": "Europe/Berlin",
    "contact_phone": "+4930987654321",
    "email": "berlin-mitte@anivahealth.com",
    "website": "https://anivahealth.com",
    "google_maps_url": null,
    "image_url": null,
    "open_hours": {
      "monday": [{ "open": "08:00", "close": "17:00" }],
      "tuesday": [{ "open": "08:00", "close": "17:00" }],
      "wednesday": [{ "open": "08:00", "close": "17:00" }],
      "thursday": [{ "open": "08:00", "close": "17:00" }],
      "friday": [{ "open": "08:00", "close": "15:00" }],
      "saturday": [],
      "sunday": []
    }
  }
]
```

> [!TIP]
>
> Brug feltet `timezone` fra lokationsobjektet, når du opbygger dit `scheduled_at`-tidsstempel. Ved at konvertere tidspunktet til lokationens lokale tidszone undgår du at booke uden for åbningstiden.

> [!WARNING]
>
> Udled ikke ledige tider ud fra `open_hours` alene. Kald [Hent ledige tider](https://docs.anivahealth.com/da/api/locations/get-availability.md), og book et starttidspunkt, som den returnerer — den tidsplan tager også højde for eksisterende bookinger, undtagelser for enkelte datoer og mindstevarsel.

**2. Opret tiden**

Send en `POST`-anmodning til `/api/v1/appointments` med profil-ID, lokations-ID og det ønskede tidspunkt. Tidspunktet skal være et starttidspunkt fra [Hent ledige tider](https://docs.anivahealth.com/da/api/locations/get-availability.md).

> [!NOTE]
>
> `scheduled_at` skal være et fremtidigt dato- og tidsstempel i ISO 8601-format, for eksempel `2026-05-12T07:30:00Z`. Tidsstempler i fortiden afvises med en `400`-fejl, og det samme gælder tider inden for [12-timers mindstevarsel](https://docs.anivahealth.com/da/api/appointments/create-appointment.md#minimumsvarsel) på Aniva-drevne lokationer.

> [!TIP]
>
> Det er sikkert at gentage denne anmodning. En profil kan kun have én tid pr. lokation og tidspunkt, så en gensendt eller dobbeltindsendt oprettelse returnerer `409` med det eksisterende `appointment_id` i stedet for at booke patienten to gange.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "profile_id": "a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56",
    "location_id": "b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421",
    "scheduled_at": "2026-05-12T07:30:00Z"
  }'
```

```javascript JavaScript theme={null}
const response = await fetch('https://anivahealth.com/api/v1/appointments', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
    profile_id: 'a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56',
    location_id: 'b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421',
    scheduled_at: '2026-05-12T07:30:00Z',
  }),
});

const appointment = await response.json();
```

En vellykket anmodning returnerer `201 Created` med tidsobjektet:

```json theme={null}
{
  "id": "c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12",
  "profile_id": "a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56",
  "location_id": "b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421",
  "scheduled_at": "2026-05-12T07:30:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "created_at": "2026-04-01T11:02:47Z",
  "updated_at": null,
  "profile": {
    "id": "a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56",
    "handle": null,
    "first_name": "Emma",
    "last_name": "Müller",
    "email": "emma.muller@example.com",
    "phone": null,
    "sex": 2,
    "date_of_birth": "1990-04-15",
    "height": null,
    "weight": null,
    "language": "de",
    "transactional_emails_enabled": null,
    "created_at": "2026-04-01T09:14:22Z",
    "updated_at": null
  },
  "panels": [],
  "individual_biomarkers": [],
  "shipments": [],
  "lab_codes": []
}
```

Gem tidens `id` — du skal bruge det til at tilføje paneler og bekræfte blodprøvetagningen.

**3. Tilføj testpaneler**

Tilknyt de testpaneler, der skal analyseres på blodprøven, ved at sende en `POST`-anmodning til `/api/v1/appointments/{id}/panels`.

Panel-ID'er er UUID'er. Kald [Vis paneler](https://docs.anivahealth.com/da/api/panels/list-panels.md) for at få de paneler, din API-nøgle kan bestille.

> [!WARNING]
>
> Paneler kan ikke tilføjes, efter blodprøvetagningen er bekræftet. Tilføj alle nødvendige paneler før bekræftelse — se [Bekræft blodprøvetagning](https://docs.anivahealth.com/da/guides/confirm-blood-draw.md) for detaljer.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/panels \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "panel_ids": [
      "d1f5a302-7c8e-4b2d-9f1a-0e3c6d4b8a27",
      "e2a7b491-5d9f-4c3e-8a2b-1f4d7e5c9b38"
    ]
  }'
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/panels',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY',
    },
    body: JSON.stringify({
      panel_ids: [
        'd1f5a302-7c8e-4b2d-9f1a-0e3c6d4b8a27',
        'e2a7b491-5d9f-4c3e-8a2b-1f4d7e5c9b38',
      ],
    }),
  }
);

const result = await response.json();
```

En vellykket anmodning returnerer `200 OK` som bekræftelse på, at panelerne er tilføjet:

```json theme={null}
{
  "success": true
}
```

## Ombooking eller aflysning

Når du har oprettet en tid, kan du stadig ændre den, før blodprøvetagningen bekræftes:

* **Ombook eller skift lokation** — Send en `PATCH`-anmodning til `/api/v1/appointments/{id}` med de felter, der skal opdateres. Se [Opdater tid](https://docs.anivahealth.com/da/api/appointments/update-appointment.md).
* **Aflys** — Send en `DELETE`-anmodning til `/api/v1/appointments/{id}`. Se [Aflys tid](https://docs.anivahealth.com/da/api/appointments/cancel-appointment.md).

> [!NOTE]
>
> Begge handlinger er kun tilgængelige før blodprøvetagningen — dvs. mens tiden har statussen
> `pending` eller `confirmed`. Når tiden skifter til `blood_drawn`, er yderligere ændringer
> ikke længere mulige.

## Fejlhåndtering

| Status | Årsag | Løsning |
| - | - | - |
| `400 Bad Request` | Et påkrævet felt mangler, `scheduled_at` ligger i fortiden, passer ikke med tidsplanen eller er inden for 12-timers mindstevarsel, eller `panel_ids` er tom. | Tjek fejl-bodyen for valideringsbeskeden, og ret anmodningen. Ved mindstevarsel skal du vælge et senere tidspunkt fra [Hent ledige tider](https://docs.anivahealth.com/da/api/locations/get-availability.md). |
| `403 Forbidden` | Din API-nøgle har ikke adgang til denne handling. | Kontakt Aniva for at bekræfte tilladelserne for din API-nøgle. |
| `404 Not Found` | `profile_id` eller `location_id` findes ikke, eller tidens ID er ugyldigt ved tilføjelse af paneler. | Tjek, at ID'erne er korrekte og tilhører din konto. |
| `409 Conflict` | Du forsøgte at tilføje paneler til eller ændre en tid, der allerede har statussen `blood_drawn` eller `cancelled`. | Yderligere ændringer er ikke mulige efter bekræftelse. |
| `409 Conflict` | Denne profil har allerede en tid på den lokation og det tidspunkt, eller tidspunktet er fuldt booket. | Ved duplikat medfølger det eksisterende `appointment_id` — brug den tid i stedet for at prøve igen. Vælg ellers et andet tidspunkt. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.