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

# Opret tid

> Book en tid til blodprøvetagning for en profil på et teststed

Book en tid til blodprøvetagning for en patientprofil på en bestemt testlokation. Når tiden er oprettet, får den som standard statussen `confirmed` (nogle lokationer kan i stedet bruge `pending` som standard — dette indstilles pr. lokation). Brug [Tilføj paneler](https://docs.anivahealth.com/da/api/appointments/add-panels.md) til at tilknytte blodprøvepaneler, før du [bekræfter blodprøvetagningen](https://docs.anivahealth.com/da/api/appointments/confirm-blood-draw.md).

> [!NOTE]
>
> En profil kan højst have **én** tid pr. lokation og tidspunkt. Opretter du en tid i et tidsrum,
> som profilen allerede har booket, returneres `409` med det eksisterende `appointment_id` i stedet
> for endnu en tid — så et nyt forsøg eller en utilsigtet gentaget anmodning aldrig kan oprette en dobbeltbooking.
> Se [Dublerede tider](#dublerede-tider).

Send en valgfri `Idempotency-Key`-header for at gøre denne oprettelse sikker at prøve igen — gentages den samme nøgle, returneres det oprindelige svar i stedet for at oprette endnu en. Se [Idempotens](https://docs.anivahealth.com/da/concepts/idempotency.md).

Kræver scopet `appointments_schedule`.

## Forespørgsel

### Body-parametre

**profile\_id** `string` *required*

UUID på den patientprofil, tiden skal oprettes for.

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

UUID på den testlokation, hvor blodprøvetagningen skal finde sted. Brug [Vis
lokationer](https://docs.anivahealth.com/da/api/locations/list-locations.md) for at finde tilgængelige lokations-ID'er.

**scheduled\_at** `string` *required*

Dato og tidspunkt for tiden i ISO 8601-format (f.eks. `2026-05-15T10:30:00Z` eller
`2026-05-15T12:30:00+02:00`). **Skal indeholde en tidszoneangivelse** — enten `Z` eller en eksplicit
forskydning som `+02:00`; tidspunkter uden tidszone afvises. Skal ligge i fremtiden.

Skal være et præcist starttidspunkt i lokationens tidsplan, og tidsrummet skal stadig have kapacitet — læs
[Hent tilgængelighed](https://docs.anivahealth.com/da/api/locations/get-availability.md) først. Tidspunkter uden for tidsplanen returnerer `400`; et tidsrum,
der er fyldt op, returnerer `409`. På Aniva-drevne lokationer skal det også ligge mindst 12 timer fremme — se
[Minimumsvarsel](#minimumsvarsel).

**results\_ready\_emails** `string[]`

Op til 5 adresser, der hver får én e-mail, når alle laboratorieresultater er endelige. E-mailen linker til
resultatsiden i Anivas adminpanel. Din nøgle skal have `results_view`-adgang til patienten, ellers
`403`. Udelad feltet for at bruge de standardadresser, der er angivet for patientens gruppe. En tom liste slår
e-mails fra. Se [E-mails om færdige resultater](https://docs.anivahealth.com/da/concepts/results.md#e-mails-nar-resultater-er-klar).

**draw\_method** `string`

Hvordan blodprøven tages: `capillary` eller `venous`. Udelad feltet for at bruge lokationens
`default_draw_method`. Lokationen skal have metoden på listen `draw_methods`, ellers `400`.

## Svar

Ved succes returnerer API'et `201 Created` med den nye tid.

**id** `string` *required*

Unikt id for tiden (UUID).

**profile\_id** `string` *required*

UUID for den profil, denne tid tilhører.

**location\_id** `string`

UUID for det teststed, hvor blodprøvetagningen finder sted.

**scheduled\_at** `string`

Planlagt dato og tidspunkt for tiden i UTC (ISO 8601 med `Z`-suffiks, f.eks.
`2026-05-15T10:30:00Z`). Kan være `null`.

**status** `string` *required*

Aktuel status for tiden. En af `pending`, `confirmed`, `blood_drawn` eller `cancelled`.
Fremdriften i laboratorieresultaterne udledes fra [Hent resultater](https://docs.anivahealth.com/da/api/appointments/get-results.md);
mere detaljeret forsendelsesfremdrift fra hvert element i det indlejrede `shipments`-array (se nedenfor)
videre til [Hent forsendelse](https://docs.anivahealth.com/da/api/shipments/get-shipment.md).

**cancellation\_reason** `string`

Fritekstårsag registreret ved aflysning af tiden (f.eks. udeblivelse, sen aflysning,
'Failed. Repeat required'). `null`, medmindre `status` er `cancelled`.

**results\_ready\_emails** `string[]` *required*

Adresser med små bogstaver, som hver modtager én e-mail, når alle laboratorieresultater er endelige. Tom, når funktionen er slået fra. Se
[E-mails når resultater er klar](https://docs.anivahealth.com/da/concepts/results.md#e-mails-nar-resultater-er-klar).

**draw\_method** `string` *required*

Hvordan blodet tages: `capillary` (fingerspids eller overarm i mikrorør) eller `venous` (fra venen
i prøveglas). Det er den metode, tiden angiver, ellers `default_draw_method` for dens
[lokation](https://docs.anivahealth.com/da/concepts/locations.md). Efter blodprøvetagningen er det den metode, der blev brugt.

**profile** `object` *required*

Den patientprofil, der er knyttet til denne tid.

**profile**

**id** `string`

Unik profilidentifikator (UUID).

**handle** `string`

Profil-handle eller brugernavn. Kan være `null`.

**first\_name** `string`

Fornavn. Kan være `null`.

**last\_name** `string`

Efternavn. Kan være `null`.

**email** `string`

E-mailadresse. Kan være `null`.

**phone** `string`

Telefonnummer i E.164-format. Kan være `null`.

**sex** `integer`

Biologisk køn efter ISO/IEC 5218. Kan være `null`.

**date\_of\_birth** `string`

Fødselsdato i `YYYY-MM-DD`-format. Kan være `null`.

**height** `number`

Højde i centimeter. Kan være `null`.

**weight** `number`

Vægt i kilogram. Kan være `null`.

**language** `string`

Foretrukket sprog: en af de 32 koder i [Opret profil](https://docs.anivahealth.com/da/api/profiles/create-profile.md).

**transactional\_emails\_enabled** `boolean`

Om denne profil modtager transaktionelle (programmatiske) e-mails. Kan være `null`.

**panels** `AppointmentPanel[]` *required*

Paneler, der aktuelt er tilknyttet denne tid. Tom for nyoprettede tider — tilknyt via
[Tilføj paneler](https://docs.anivahealth.com/da/api/appointments/add-panels.md). Slå paneldetaljer (navn, biomarkører) op via
[Vis paneler](https://docs.anivahealth.com/da/api/panels/list-panels.md).

**Felter for tilknyttet panel**

**panel\_id** `string`

Panelets UUID — krydsreferer med [Vis paneler](https://docs.anivahealth.com/da/api/panels/list-panels.md).

**added\_at** `string`

ISO 8601-tidsstempel for, hvornår panelet første gang blev knyttet til denne tid.

**individual\_biomarkers** `AppointmentIndividualBiomarker[]` *required*

À la carte-biomarkører tilknyttet denne tid uden for et panel. Tom for nyoprettede
tider — tilknyt via [Tilføj individuelle biomarkører](https://docs.anivahealth.com/da/api/appointments/add-individual-biomarkers.md).
Slå hvert `biomarker_id` op i [Vis biomarkører](https://docs.anivahealth.com/da/api/biomarkers/list-biomarkers.md)
for visningsdata.

**Felter for individuel biomarkør**

**biomarker\_id** `integer`

Biomarkør-id — krydsreferer med
[Vis biomarkører](https://docs.anivahealth.com/da/api/biomarkers/list-biomarkers.md).

**added\_at** `string`

ISO 8601-tidsstempel for, hvornår biomarkøren første gang blev knyttet til denne tid.

**shipments** `AppointmentShipmentLink[]` *required*

Forsendelser tilknyttet denne tid, med ældste tilknytning først. Tom for nyoprettede tider —
tilknyt via [Opret forsendelse](https://docs.anivahealth.com/da/api/shipments/create-shipment.md) (med `appointment_id`) eller
[Tilknyt tider til forsendelse](https://docs.anivahealth.com/da/api/shipments/attach-appointments-to-shipment.md).

**Felter for forsendelseslink**

**id** `string`

Forsendelsens reference-id — krydsreferer med
[Hent forsendelse](https://docs.anivahealth.com/da/api/shipments/get-shipment.md).

**added\_at** `string`

ISO 8601-tidsstempel for, hvornår forsendelsen første gang blev knyttet til denne tid.

**lab\_codes** `string[]` *required*

Laboratoriekoder (stregkoder på prøveglas) registreret for denne tid i scanningsrækkefølge. Tom, indtil blodprøvetagningen
er bekræftet. En venøs blodprøvetagning har én kode trykt på hvert prøveglas; en kapillær blodprøvetagning har én
kode pr. mikrorør. Resultater og dokumenter i [Hent resultater](https://docs.anivahealth.com/da/api/appointments/get-results.md) henviser
til disse koder via `lab_code`.

## Minimumsvarsel

Tider på Aniva-drevne lokationer skal bookes mindst **12 timer** i forvejen; booking inden for
det tidsrum returnerer `400`. [Hent tilgængelighed](https://docs.anivahealth.com/da/api/locations/get-availability.md) udelader
allerede disse tidsrum, så alt, du læser fra den tidsplan, kan bookes.

Lokationer, du selv driver, har intet minimumsvarsel — booking samme dag og walk-in er uændret.

## Dublerede tider

En profil kan højst have én ikke-aflyst tid pr. lokation og tidspunkt — én person kan ikke få taget
blodprøve to gange samme sted på samme tidspunkt, uanset hvor mange stole lokationen har.

Opretter du en tid i et tidsrum, som profilen allerede har booket, returneres `409` med et
`appointment_id`, der angiver den tid, der allerede findes:

```json theme={null}
{
  "error": "This profile already has an appointment at this location and time. Reschedule or cancel the existing appointment instead of creating a second one.",
  "appointment_id": "03e916d2-7fd6-4414-8276-8532a105edc3"
}
```

Håndter det ved at betragte anmodningen som allerede gennemført: hent tiden med
[Hent tid](https://docs.anivahealth.com/da/api/appointments/get-appointment.md), flyt den med
[Opdater tid](https://docs.anivahealth.com/da/api/appointments/update-appointment.md), eller aflys den med
[Aflys tid](https://docs.anivahealth.com/da/api/appointments/cancel-appointment.md). Prøv ikke at oprette igen — det bliver ved med
at returnere `409`.

Det gør gentagne oprettelser sikre: en anmodning, du sender igen efter en timeout, eller en formular indsendt to gange,
kan ikke oprette to tider til den samme patient på det samme tidspunkt.

> [!NOTE]
>
> `appointment_id` er kun med på dublet-`409`. Kapacitets-`409` — når tidsrummet er fyldt,
> fordi *andre* patienter har booket det — returnerer kun `error`, og den rette løsning her er at vælge
> et andet tidsrum fra [Hent tilgængelighed](https://docs.anivahealth.com/da/api/locations/get-availability.md).

## Fejlsvar

| Status | Beskrivelse |
| - | - |
| `400` | Valideringsfejl — f.eks. ligger `scheduled_at` i fortiden, er mindre end 12 timer ude på en Aniva-drevet lokation, er ikke en præcis starttid i lokationens tidsplan, eller lokationen har ikke beholdere på lager til `draw_method`. |
| `403` | Adgang nægtet — din API-nøgle har ikke adgang til denne handling, eller `results_ready_emails` er sat uden `results_view`-adgang til patienten. |
| `404` | Profil eller lokation blev ikke fundet, eller lokationen er inaktiv. |
| `409` | Denne profil har allerede en tid på denne lokation og dette tidspunkt (indeholder `appointment_id`), tidspunktet er fuldt booket, lokationen er lukket på den dato, eller `Idempotency-Key` blev genbrugt med en anden body, eller den oprindelige forespørgsel er ikke afsluttet. |
| `500` | Intern serverfejl. |

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "scheduled_at": "2026-05-15T10:30:00Z"
  }'
```

```json 201 theme={null}
{
  "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
  "scheduled_at": "2026-05-15T10:30:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "draw_method": "venous",
  "created_at": "2026-04-01T09:45:00Z",
  "updated_at": null,
  "profile": {
    "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "handle": null,
    "first_name": "Maria",
    "last_name": "Schmidt",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "height": 168,
    "weight": 65,
    "language": "de",
    "transactional_emails_enabled": true,
    "created_at": "2026-04-01T09:14:32Z",
    "updated_at": null
  },
  "panels": [],
  "individual_biomarkers": [],
  "shipments": [],
  "lab_codes": []
}
```

```json 400 theme={null}
{
  "error": "Appointments must be booked at least 12 hours in advance. Please pick a later time."
}
```

```json 404 theme={null}
{
  "error": "Location not found or inactive"
}
```

```json 409 theme={null}
{
  "error": "This profile already has an appointment at this location and time. Reschedule or cancel the existing appointment instead of creating a second one.",
  "appointment_id": "03e916d2-7fd6-4414-8276-8532a105edc3"
}
```


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