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

# Tider

> Sådan fungerer tider til blodprøvetagning i Anivas laboratorietest-API: booking, paneler, biomarkører, statusændringer og afbestilling.

En tid er en planlagt blodprøvetagning for en patientprofil på et fysisk teststed, udført af en sundhedsperson. Kits, der sendes med posten til en patient, er ikke tider — se [Ordrer på hjemmetestkits](https://docs.anivahealth.com/da/concepts/home-kit-orders.md).

## Felter

**id** `string` *required*

UUID autogenereret af Aniva. Brug dette til at tilføje paneler, bekræfte blodprøvetagningen og hente resultater.

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

UUID for den profil, denne tid tilhører.

**location\_id** `string`

UUID for det teststed, hvor blodprøvetagningen finder sted. Hjemmetestkits er ikke tider — se
[Ordrer på hjemmetestkits](https://docs.anivahealth.com/da/concepts/home-kit-orders.md).

**scheduled\_at** `string`

Planlagt dato og tidspunkt for blodprøvetagningen i ISO 8601-format. Returneres altid som et
UTC-tidspunkt med et `Z`-suffiks (f.eks. `2026-04-15T08:30:00Z`). Ved oprettelse / opdatering
**skal værdien indeholde en tidszoneangivelse** (enten `Z` eller en eksplicit forskydning som
`+02:00`) — tidspunkter uden tidszone afvises. Skal ligge i fremtiden og på Aniva-drevne
lokationer mindst 12 timer fremme ([mindste
varsel](https://docs.anivahealth.com/da/api/appointments/create-appointment.md#minimumsvarsel)).

**status** `string` *required*

Aktuel livscyklusstatus. En af `pending`, `confirmed`, `blood_drawn` eller `cancelled`. Se
[Livscyklus](#livscyklus) nedenfor. Færdiggørelsesstatus for laboratorieresultater (`in_progress` vs. `completed`)
hentes fra [Hent resultater](https://docs.anivahealth.com/da/api/appointments/get-results.md); mere detaljeret forsendelsesstatus (undervejs,
leveret osv.) hentes ved at følge hvert element i det indlejrede `shipments`-array 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.

**created\_at** `string` *required*

ISO 8601-tidsstempel for, hvornår tiden blev oprettet.

**updated\_at** `string`

ISO 8601-tidsstempel for den seneste opdatering. Null, hvis tiden aldrig er blevet opdateret.

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

Laboratoriekoder (stregkoder på prøveglas) registreret ved [Bekræft blodprøvetagning](https://docs.anivahealth.com/da/api/appointments/confirm-blood-draw.md),
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. mikrotainer. Resultater og dokumenter henviser til disse via
`lab_code`.

**panels** `object[]` *required*

Paneler knyttet til denne tid som `{ panel_id, added_at }`-elementer. Se
[Tilføjelse af paneler](#tilfoj-paneler).

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

Enkeltstående biomarkører knyttet til denne tid som `{ biomarker_id, added_at }`-elementer. Se
[Individuelle biomarkører](#individuelle-biomarkorer).

**shipments** `object[]` *required*

Forsendelser knyttet til denne tid som `{ id, added_at }`-elementer med den ældste tilknytning først. Se
[Tilknytning af forsendelser](#tilknyt-forsendelser).

**profile** `object` *required*

Det fulde profilobjekt for patienten, indlejret i hvert svar for en tid. Felterne nedenfor
er et udsnit. [Hent tid](https://docs.anivahealth.com/da/api/appointments/get-appointment.md) viser dem alle.

**egenskaber**

**id** `string`

UUID for den tilknyttede profil.

**first\_name** `string`

Patientens fornavn.

**last\_name** `string`

Patientens efternavn.

**email** `string`

Patientens e-mailadresse.

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

Fødselsdato i `YYYY-MM-DD`-format.

**sex** `integer`

Biologisk køn i henhold til ISO/IEC 5218.

## Livscyklus

Tider har fire livscyklustilstande:

```
pending → confirmed → blood_drawn
   │          │             │
   └──────────┴─────────────┴──→ cancelled
```

| Status | Betydning |
| - | - |
| `pending` | Tiden er booket og afventer bekræftelse. Kan [opdateres](https://docs.anivahealth.com/da/api/appointments/update-appointment.md) eller [aflyses](https://docs.anivahealth.com/da/api/appointments/cancel-appointment.md). |
| `confirmed` | Tidsbestillingen er bekræftet (f.eks. af klinikken), men blodprøven er endnu ikke taget. Kan stadig opdateres eller aflyses. |
| `blood_drawn` | Laboratoriekoderne er indsendt via [Bekræft blodprøvetagning](https://docs.anivahealth.com/da/api/appointments/confirm-blood-draw.md), og laboratorieordreflowet er sat i gang. Panelerne er låst, og tiden kan ikke flyttes eller aflyses. |
| `cancelled` | Tiden er aflyst. Endelig tilstand — ingen yderligere overgange. |

> [!NOTE]
>
> Statusoversigten for tider er bevidst overordnet — mere detaljeret fremdrift vises
> via dedikerede endpoints:
>
> * **Færdiggørelse af laboratorieresultater** →
>   [Hent resultater](https://docs.anivahealth.com/da/api/appointments/get-results.md) — topniveau-feltet `status` er `in_progress` eller
>   `completed`.
> * **Forsendelsesfremdrift** (undervejs, leveret osv.) → følg hvert element i det indlejrede
>   `shipments`-array på tiden til [Hent forsendelse](https://docs.anivahealth.com/da/api/shipments/get-shipment.md) — hver
>   forsendelse har sin egen `status` og en `status_updates`-hændelseslog.
>
> Hver statusændring sender en `appointment.*`-[webhook](https://docs.anivahealth.com/da/concepts/webhooks.md), for eksempel
> `appointment.confirmed`. Et nyt tidspunkt eller en ny lokation sender `appointment.rescheduled`.

> [!WARNING]
>
> Bekræftelse af en tid (at flytte den til `blood_drawn`) er **uigenkaldelig**. Når du først har indsendt
> laboratoriekoden/-koderne, sættes laboratorieordreflowet i gang og kan ikke fortrydes. Opdateringer og aflysninger
> er kun tilladt, mens tiden har status `pending` eller `confirmed`.

## Visning af tider

Hent alle tider, som din API-nøgle har adgang til:

```
GET /api/v1/appointments
```

Du kan valgfrit angive `?profile_id={uuid}` for at filtrere efter en bestemt profil. Uden denne parameter anvendes et standardtidsvindue (seneste 2 måneder til kommende 1 måned).

## Opdatering af en tid

Før blodprøvetagningen er bekræftet, kan du flytte tiden eller ændre teststedet:

```
PATCH /api/v1/appointments/{id}
```

Angiv en hvilken som helst kombination af `scheduled_at`, `location_id`, `draw_method` og `results_ready_emails` for at opdatere. Medtag kun de felter, du vil ændre.

## Prøvetagningsmetode

Hver tid har en `draw_method`: `capillary` (fingerspids eller overarm, i mikrotainere) eller
`venous` (fra venen, i prøveglas). Den gælder kun for blodprøvetagningen. Urinprøver, podninger og andre
prøver, der ikke er blodprøver, opsamles på samme måde uanset metode.

Som standard er det lokationens `default_draw_method`. Angiv `draw_method` ved oprettelse eller opdatering for at
bruge en anden metode, eller sæt den til `null` for at gå tilbage til lokationens standard. Lokationen skal have
metoden opført i sin `draw_methods`, og de bookede prøver skal kunne udføres med den, ellers returnerer anmodningen
`400`. Du kan ikke ændre den efter blodprøvetagningen. Efter blodprøvetagningen er `draw_method` den
metode, der blev brugt.

## Én tid pr. profil, lokation og tidspunkt

En profil kan højst have én ikke-aflyst tid pr. `(location_id, scheduled_at)`-par — én
person kan ikke få taget blodprøve to gange på samme sted på samme tidspunkt, uanset hvor mange parallelle bookinger
lokationen accepterer.

Både [Opret tid](https://docs.anivahealth.com/da/api/appointments/create-appointment.md) og
[Opdater tid](https://docs.anivahealth.com/da/api/appointments/update-appointment.md) håndhæver dette og returnerer `409` med et
`appointment_id`, der peger på den tid, som allerede findes. Behandl dette svar som allerede
booket frem for en fejl, der skal forsøges igen: hent, flyt eller aflys den angivne tid.

Den praktiske effekt er, at gentagne oprettelser er sikre. En oprettelse, du sender igen efter en
netværkstimeout, eller som en bruger udløser to gange, bliver til én enkelt tid i stedet for to –
hvilket også betyder, at du aldrig behøver at rydde op i dobbeltbookinger for samme patient bagefter.

> [!NOTE]
>
> Opdateringer er kun tilladt før blodprøvetagningen – dvs. mens tiden har statussen `pending`
> eller `confirmed`. Når tiden skifter til `blood_drawn` eller er blevet `cancelled`, kan den ikke
> ændres. Den eneste undtagelse er `results_ready_emails`: du kan stadig ændre det alene efter
> blodprøvetagningen.

## Aflys en tid

Aflys en tid, der ikke længere er brug for:

```
DELETE /api/v1/appointments/{id}
```

Det sætter tidens status til `cancelled`. Den aflyste tid returneres i svaret.

Du kan valgfrit sende en `cancellation_reason` (op til 500 tegn) i bodyen for at angive årsagen. Den
gemmes på tiden og returneres som `cancellation_reason` ved senere opslag.

> [!NOTE]
>
> Aflysning er kun tilladt før blodprøvetagningen – dvs. mens tiden har statussen `pending` eller
> `confirmed`. Tider, der allerede er skiftet til `blood_drawn`, kan ikke aflyses.

## Tilføj paneler

Før du bekræfter blodprøvetagningen, skal du tilføje de blodprøvepaneler, du vil køre, ved at kalde:

```
POST /api/v1/appointments/{id}/panels
```

Send et array af panel-UUID'er i feltet `panel_ids`. Panel-ID'er udleveres af Aniva til din partnerkonto.

> [!NOTE]
>
> Paneler skal tilføjes før blodprøvetagningen – dvs. mens tiden har statussen `pending` eller
> `confirmed`. Du kan ikke tilføje eller ændre paneler, når tiden er skiftet til `blood_drawn`.

## Fjern paneler

Hvis du har brug for at fjerne paneler før blodprøvetagningen, så kald:

```
DELETE /api/v1/appointments/{id}/panels
```

Send et array af panel-UUID'er i feltet `panel_ids`. Fjernelsen er idempotent: et panel, der ikke er tilknyttet, ignoreres.

> [!NOTE]
>
> Ligesom tilføjelse af paneler er fjernelse kun tilladt før blodprøvetagningen – dvs. mens tiden
> har statussen `pending` eller `confirmed`. Paneler kan ikke fjernes, når tiden er skiftet til
> `blood_drawn`.

## Individuelle biomarkører

Du kan tilknytte individuelle biomarkører til en tid som à la carte-test uden for et færdigt panel. Det er nyttigt, når en behandler ønsker et skræddersyet udvalg frem for en foruddefineret pakke. De tilknyttede biomarkører vises i svaret for tiden som et `individual_biomarkers`-array (på samme niveau som `panels`). Routingbeslutninger træffes nedstrøms af ordrelogistik-pipelinen baseret på hver biomarkørs mapping pr. laboratorium.

Tilføj biomarkører (idempotent – allerede tilknyttede biomarkører beholdes):

```
PATCH /api/v1/appointments/{id}/biomarkers
```

Fjern biomarkører (idempotent – biomarkører, der ikke er tilknyttet, ignoreres):

```
DELETE /api/v1/appointments/{id}/biomarkers
```

Begge endpoints tager et `biomarker_ids`-array og validerer det samlede sæt mod hvert laboratoriums afhængighedsregler – en ordre, der ikke kan afgives korrekt (f.eks. et CRP/HDL-forhold uden CRP og HDL), returnerer `400` med de biomarkører, du skal tilføje, og gemmer intet. Brug [Vis biomarkører](https://docs.anivahealth.com/da/api/biomarkers/list-biomarkers.md) til at finde biomarkør-ID'er.

> [!NOTE]
>
> Ligesom ændringer i paneler kan individuelle biomarkører kun tilføjes eller fjernes før
> blodprøvetagningen – dvs. mens tiden har statussen `pending` eller `confirmed`. Når tiden skifter
> til `blood_drawn`, fastlåses det tilpassede snapshot.

## Forhåndsvis beholderkrav

Når du har tilføjet paneler eller individuelle biomarkører, kan du forhåndsvise de fysiske prøvebeholdere, der skal bruges til prøvetagningen:

```
GET /api/v1/appointments/{id}/preview
```

Svarets `containers`-array indeholder type, navn, lågfarve, volumen, producentens varenummer og antal for hver påkrævet beholder. Det hjælper behandlere med at klargøre de rigtige materialer før blodprøvetagningen. Svaret indeholder også et `pricing`-objekt – tidens samlede opgørelse (de udløste poster, de tilknyttede paneler og én linje pr. leveret biomarkør, prissat efter din prisliste med detailpris ved siden af; se [Prissætning](https://docs.anivahealth.com/da/concepts/pricing.md)), som udfyldes, når tiden har tilknyttede prøver, og din nøgle har scopet `prices_view`, ellers `null`. `routing` eksponeres bevidst aldrig og er altid `null`.

> [!NOTE]
>
> Forhåndsvisningen afspejler de aktuelt tilknyttede paneler og biomarkører. Hvis du tilføjer eller
> fjerner paneler efter forhåndsvisningen, skal du kalde forhåndsvisningsendpointet igen for at få
> opdaterede beholderkrav.

## Bekræft blodprøvetagningen

Efter blodprøvetagningen indsender du laboratoriekoderne (prøveglassenes stregkoder) for at starte laboratorieordre-pipelinen:

```
POST /api/v1/appointments/{id}/confirm
```

Send `lab_code`, når den samme kode står på alle glas (venøs blodprøvetagning), eller `lab_codes` med
én post pr. kode – hver med de `panel_ids`, den dækker – når hvert panel tages i sine egne glas med
sin egen kode (kapillær blodprøvetagning). Hvert panel bliver så sin egen laboratorierekvisition
under sin kode. Koderne returneres som `lab_codes` på tiden.

Ved en kapillær blodprøvetagning pakkes prøven i microtainers. Paneler kommer først i bookingrækkefølge.
Individuelle biomarkører fylder derefter den ledige plads i panelernes microtainers. Når de skal bruge
mere plads, åbner de nye microtainers. Vi fordeler dem jævnt. Hver microtainer rummer højst 150 µl
individuelle biomarkører. Kald, der ændrer paneler eller biomarkører, svarer `400`, når det samlede
sæt bryder denne regel.

Det skifter tidens status til `blood_drawn` og starter behandlingen på laboratoriet. Handlingen kan ikke fortrydes.

## Afhentning af forsendelse

> [!WARNING]
>
> `POST /api/v1/appointments/pickup` er blevet **fjernet** sammen med statussen `shipment_picked_up`
> for tider. Det svarer nu `405 Method Not Allowed`, fordi stien falder igennem til
> appointment-by-id-ruten. Endpointet fungerede i sin sidste fase som en no-op, der tog imod kaldet
> uden at gøre noget, så fjernelsen ændrer ingen adfærd, du var afhængig af.

For at følge forløbet efter blodprøvetagningen kan du følge hver post i tidens indlejrede `shipments`-array
til [Hent forsendelse](https://docs.anivahealth.com/da/api/shipments/get-shipment.md) – hver forsendelse har sin egen `status` og en
`status_updates`-historik.

## Tilknyt forsendelser

En tid kan knyttes til én eller flere forsendelser (og omvendt – relationen er mange-til-mange). De
aktuelle tilknytninger vises indlejret på begge sider:

* på tiden som et `shipments`-array med `{ id, added_at }`-poster;
* på forsendelsen som et `appointments`-array med `{ id, added_at }`-poster.

Begge arrays er sorteret med den ældste tilknytning først. Hvert `id` henviser til det kanoniske
detalje-endpoint ([Hent forsendelse](https://docs.anivahealth.com/da/api/shipments/get-shipment.md) /
[Hent tid](https://docs.anivahealth.com/da/api/appointments/get-appointment.md)) for den fulde payload.

Forsendelser tilknyttes ved oprettelsen via feltet `appointment_id` på
[Opret forsendelse](https://docs.anivahealth.com/da/api/shipments/create-shipment.md). Efter oprettelsen administrerer du tilknytninger
fra forsendelsen med [Tilknyt tider til forsendelse](https://docs.anivahealth.com/da/api/shipments/attach-appointments-to-shipment.md)
og [Fjern tider fra forsendelse](https://docs.anivahealth.com/da/api/shipments/detach-appointments-from-shipment.md); begge returnerer
den opdaterede liste over tider for forsendelsen. For at læse en tids pakker i fuldt omfang
bruger du [Vis forsendelser](https://docs.anivahealth.com/da/api/shipments/list-shipments.md) med `?appointment_id=`.

Reglen for ændringer er: Tilknytninger kan oprettes eller fjernes, når ENTEN

* tiden er forbi blodprøvetagningen (`blood_drawn`), eller
* forsendelsen blev oprettet for mindre end 24 timer siden.

Uden for det tidsrum er tilknytningen låst, så historiske data forbliver stabile.

## Hent laboratorieresultater

Når laboratoriet har behandlet blodprøverne, kan du hente kliniske og genetiske resultater:

```
GET /api/v1/appointments/{id}/results
```

Svaret indeholder planlagte tests (status `planned`) sammen med modtagne resultater, så du kan
følge med i, hvad der stadig afventer. Feltet `status` på øverste niveau er `in_progress`, indtil
hver indsendelse er afsluttet, og derefter `completed` (eller `fault`, hvis ingen af dem har
rapporteret) – brug dette til at afgøre, om laboratoriearbejdet for tiden er færdigt. En
`appointment.results.completed`-[webhook](https://docs.anivahealth.com/da/concepts/webhooks.md) giver dig besked, når det sker, så
du ikke behøver at polle. Arrayet `submissions` opdeler dette pr. laboratorierekvisition, hver med
sin egen `lab_code`. Hvert modtaget resultat og dokument har den `lab_code`, det blev registreret
under. Laboratorierapporter i PDF-format er refereret i arrayet `documents` – brug
`GET /api/v1/documents/{id}` til at downloade dem.

## Eksempel på en tid

```json theme={null}
{
  "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "profile_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "location_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "scheduled_at": "2026-04-15T08:30:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "draw_method": "venous",
  "created_at": "2026-04-01T10:00:00Z",
  "updated_at": null,
  "profile": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "handle": null,
    "first_name": "Jane",
    "last_name": "Doe",
    "email": "jane.doe@example.com",
    "phone": "+4930123456789",
    "sex": 2,
    "date_of_birth": "1990-06-15",
    "height": 170,
    "weight": 62,
    "language": "en",
    "transactional_emails_enabled": true,
    "created_at": "2026-04-01T09:55:00Z",
    "updated_at": null
  },
  "panels": [
    {
      "panel_id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
      "added_at": "2026-04-01T10:05:00Z"
    }
  ],
  "individual_biomarkers": [
    {
      "biomarker_id": 42,
      "added_at": "2026-04-01T10:07:00Z"
    }
  ],
  "shipments": [
    {
      "id": "P2611194821",
      "added_at": "2026-04-15T07:00:00Z"
    }
  ],
  "lab_codes": []
}
```


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