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

# Resultater

> Sådan fungerer laboratorieresultater og dokumenter i Anivas API: biomarkørværdier, referenceintervaller, laboratorierapporter og resultatwebhooks.

Når en blodprøvetagning er bekræftet, og laboratoriet har behandlet prøverne, bliver resultaterne tilgængelige på tiden. Resultater hentes via `GET /api/v1/appointments/{id}/results` og omfatter kliniske biomarkørresultater, genetiske biomarkørresultater samt laboratorierapporter, der kan downloades.

## Resultatstatus

Feltet `status` på øverste niveau i resultatsvaret angiver den samlede behandlingsstatus:

| Status | Betydning |
| - | - |
| `in_progress` | Nogle indsendelser er stadig under behandling på laboratoriet. |
| `completed` | Alle indsendelser er afsluttet, og mindst én har rapporteret. |
| `fault` | Alle indsendelser er mislykkedes uden at rapportere. Der afventes ikke flere resultater. |

De enkelte resultater i svaret har deres egen status pr. resultat (se nedenfor), så du kan vise delresultater, mens den samlede status stadig er `in_progress`.

Abonner på [webhooks](https://docs.anivahealth.com/da/concepts/webhooks.md) for at få besked, når resultater ændrer sig. `appointment.results.updated` udløses ved hver ændring i resultatindholdet, og `appointment.results.completed` udløses, når status på øverste niveau skifter til `completed`. Ordrer på hjemmetestkit sender de samme hændelser med præfikset `home_kit_order.`. Hver hændelse indeholder URL'en til de resultater, der skal hentes. Du kan stadig polle dette endpoint for at afstemme.

Arrayet `submissions` opdeler status på øverste niveau pr. laboratorierekvisition. En blodprøvetagning, der omfatter flere rør eller flere laboratorier, har flere poster, hver med den `lab_code` (rørstregkode), den blev indsendt under, og sin egen `in_progress` / `completed` / `fault`-status. En `fault`-post blev afvist eller opgivet på laboratoriet og vil aldrig rapportere: Prøven er ofte blevet flyttet til et andet laboratorium, som derefter opretter sin egen post. Status på øverste niveau er `completed`, når alle poster er afsluttet, og mindst én har rapporteret. Hvert modtaget resultat og hvert dokument har den samme `lab_code`, så du kan se, hvilket rør en værdi kommer fra.

## Kliniske resultater

Kliniske resultater er almindelige målinger af biomarkører i blodet — såsom D-vitaminniveau, kolesterol, stofskiftehormoner og lignende.

Hvert klinisk resultat indeholder:

* **`id`** — id'et for resultatrækken fra laboratoriet. Det forbliver det samme, når laboratoriet retter rækken, så brug det til upsert. `null` for et `planned`-resultat.
* **`biomarker_name`** og **`category`** — hvad der blev målt, og hvilken gruppe det hører under (f.eks. vitaminer, hormoner).
* **`lab_code`** — den laboratoriekode (rørstregkode), resultatet blev indsendt under, en af ordrens laboratoriekoder. `null` for et `planned`-resultat og for resultater, laboratoriet rapporterede uden kode.
* **`value`** og **`value_operator`** — selve målingen. Operatoren er `eq` (lig med) for eksakte værdier eller `lt`/`gt`, når laboratoriet rapporterer en værdi under eller over det målbare område.
* **`unit`** — måleenheden (f.eks. ng/mL, µIU/mL).
* **`reference_range_lab`** — normale og optimale min.- og maks.-grænser som rapporteret af laboratoriet for dette resultat, omregnet til samme skala som `value`. En grænse, som laboratoriet lader stå åben, er `null`, så et ensidigt interval som `< 50` kommer som `normal_min: null, normal_max: 50`. Hvert resultat har det interval, det blev målt op imod, så en patient med resultater fra flere blodprøvetagninger eller laboratorier får det rigtige pr. resultat.
* **`reference_range_lab_absent_reason`** — hvorfor `reference_range_lab` er `null`. `null`, når intervallet er til stede, samt på et `planned`-resultat. Se [Når der ikke er noget laboratorieinterval](#nar-der-ikke-er-noget-laboratorieinterval).
* **`aniva_range`** — sammenligningsværdier, som Aniva har samlet, på samme skala som `value`. De varierer efter alder, køn og graviditetsuge. `normal_*` er det generelle interval. `optimal_*` er et smallere interval. Værdierne er kun til information. De er ikke lægefaglig rådgivning, ikke en diagnose og ikke en vurdering af resultatet. Aniva sætter ingen markering ud fra dem. Brug `reference_range_lab` som standard for resultatet. `null`, når din nøgle ikke har scopet `aniva_ranges_view`, eller når Aniva ikke har værdier for denne biomarkør.
* **`tested_at`** — datoen for, hvornår testen blev udført.
* **`comment`** — fritekstbemærkning fra laboratoriet til dette specifikke resultat (f.eks. vejledning om referenceinterval, advarsler om prøvekvalitet). `null`, når laboratoriet ikke har vedhæftet en.
* **`status_reason`** — hvorfor et `likely_wrong`-resultat er tvivlsomt, eller hvorfor et `fault`- eller `undeliverable`-resultat er ubrugeligt. `null` for alle andre statusser. Adskiller sig fra `comment`, som er laboratoriets egen note og ofte er tom ved fejlbehæftede resultater.
* **`origin`** — hvem der leverede dokumentet, som værdien stammer fra, med de samme værdier som dokumentets `origin` nedenfor. En værdi fra et uploadet dokument (`member_upload`, `staff_upload`, `partner_upload`) kommer fra, at Aniva aflæser filen, ikke fra en laboratorierapport: Tjek den op imod filen før klinisk brug. `null` for et `planned`-resultat.
* **`lab_reported`** — det udførende laboratoriums egen rapportlinje, ordret og uomregnet. Se nedenfor.

### Aniva-intervaller

`aniva_range` indeholder sammenligningsværdier, som Aniva har samlet fra publicerede kilder og
egen kuratering. Intervallerne varierer efter alder, køn og graviditetsuge.
`sources` viser de publicerede kilder, som Aniva har registreret for værdierne. Listen kan være tom.

> [!WARNING]
>
> Værdierne er generel information. De er ikke lægefaglig rådgivning, ikke en diagnose, ikke et
> medicinsk fund og ikke en vurdering af et resultat. Aniva stiller dem ikke til rådighed som
> medicinsk udstyr. Aniva sammenligner ikke et resultat med dem og sætter ingen markering ud fra dem.
> `reference_range_lab` og en læges vurdering forbliver standarden for et resultat.

Regler for dit produkt:

* Vis kun Aniva-intervallet som supplement til laboratoriets interval, aldrig i stedet for det.
* Hvis du udleder en markering, en advarsel eller en anbefaling fra Aniva-intervallet, gør du det i
  eget navn og på eget ansvar.
* Vis meddelelsen fra din aftale med Aniva, overalt hvor du viser Aniva-intervallet.

For at få adgang skal du underskrive den korte aftale om Aniva-intervaller. Derefter tilføjer vi
scopet `aniva_ranges_view` til din nøgle. Værdierne kan ændres uden varsel.

### Normaliserede værdier versus laboratoriets egen linje

`value`, `unit` og `reference_range_lab` er normaliserede: Vi omregner hver måling til biomarkørens standardenhed og rapporterer den under vores eget biomarkørnavn, så den samme analyt kan sammenlignes på tværs af laboratorier og over tid. Det er det, du har brug for til tendenser og sammenligning på tværs af laboratorier, men det er ikke det, en læge, der gennemgår svaret, ser på laboratoriets PDF — basisk fosfatase udskrevet som `48 U/l (40 - 129)` når frem til dig som `0.8 µkat/L`.

`lab_reported` indeholder den udskrevne linje ved siden af: laboratoriets analytnavn og -kode, værdi og enhed som udskrevet, referenceintervallet både som tekst (`< 50`, `> 55`, `40 - 129`) og som laboratoriets egne uomregnede grænser samt dets afvigelsesmarkering, resultatstatus og note.

Brug `lab_reported`, når et menneske afstemmer dine data med laboratoriets rapport, og standardfelterne til alt, der beregnes. Kun felter, som laboratoriet faktisk har sendt, udfyldes; intet i `lab_reported` udledes, får standardværdier eller omregnes, og hele objektet er `null`, når vi ikke har nogen rådata for et resultat.

### Når der ikke er noget laboratorieinterval

Når `reference_range_lab` er `null`, fortæller `reference_range_lab_absent_reason` dig hvorfor:

| Værdi | Betydning | Vis |
| - | - | - |
| `not_provided` | Der findes intet interval. Laboratoriet sendte intet. | "Ikke relevant" |
| `lab_text_only` | Laboratoriet udskrev kun tekst, f.eks. et mål, et risikoniveau eller et interval for en livsfase. | Teksten i `lab_reported.reference_range` |
| `not_measured` | Resultatet er `undeliverable`, så der er ingen værdi at sammenligne. | `status_reason` |

Nogle laboratorier udskriver et mål eller et risikoniveau i stedet for et referenceinterval, for eksempel
`Ziel: <200. >240 hoch` eller `<5.7 neg >=6.5 pos`. Disse kommer ikke med i `reference_range_lab`, så
grænserne er `null`, og årsagen er `lab_text_only`. Vis den udskrevne tekst ordret.

Et ensidigt interval som `< 20` er et interval. Det kommer i `reference_range_lab` med én grænse sat til
`null`, og årsagen er `null`. Hold den åbne side åben, når du viser det.

### Statusser for kliniske resultater

| Status | Betydning |
| - | - |
| `planned` | Testen er bestilt, men resultaterne er endnu ikke kommet fra laboratoriet. |
| `received` | Laboratoriet har returneret et resultat. |
| `corrected` | En person har gennemgået og rettet den værdi, laboratoriet rapporterede. |
| `likely_wrong` | Anivas automatiske tjek eller medlemmet betvivler værdien. Ikke bekræftet: Vis den ikke som et fund uden gennemgang. Se `status_reason`. |
| `fault` | Laboratoriet leverede et resultat, der er bekræftet forkert — **må ikke bruges klinisk**. `value` indeholder stadig det forkerte tal; se `status_reason`. |
| `undeliverable` | Laboratoriet kunne ikke producere en værdi. `value` er `null`; se `status_reason`. |

> [!TIP]
>
> Brug feltet `value` direkte, når du viser resultater til patienter — det afspejler allerede den
> rettede værdi, når der findes en.

> [!WARNING]
>
> Vis aldrig et `fault`-resultat som et fund — dets `value` er udfyldt, men bekræftet forkert.

## Genetiske resultater

Genetiske resultater er fund på genniveau fra en DNA-analyse. Hvert resultat svarer til et gen (f.eks. APOE, MTHFR) og indeholder:

* **`id`** — id'et for resultatrækken fra laboratoriet. Det forbliver det samme, når laboratoriet retter rækken, så brug det til upsert. `null` for et `planned`-resultat.
* **`gene`** — gensymbolet.
* **`lab_code`** — den laboratoriekode (rørstregkode), resultatet blev indsendt under. `null` for et `planned`-resultat og for resultater, laboratoriet rapporterede uden kode.
* **`genotype`** — den påviste genotype (f.eks. E3/E4).
* **`clinical_significance`** — en ACMG-baseret klassificering af fundet.
* **`risk_description`** — en letlæselig forklaring på, hvad genotypen betyder.
* **`comment`** — fritekstbemærkning fra laboratoriet til dette specifikke resultat. `null`, når laboratoriet ikke har vedhæftet en.
* **`status_reason`** — hvorfor et `likely_wrong`-resultat er tvivlsomt, eller hvorfor et `fault`- eller `undeliverable`-resultat er ubrugeligt. `null` for alle andre statusser.
* **`origin`** — hvem der leverede dokumentet, som værdien stammer fra, ligesom ved kliniske resultater.
* **`variants`** — de specifikke påviste genetiske varianter, hver med detaljer på SNV-niveau.

### Værdier for klinisk signifikans

| Værdi | Kategori |
| - | - |
| `pathogenic`, `likely_pathogenic` | Sygdomsfremkaldende eller sandsynligvis sygdomsfremkaldende |
| `uncertain` | Variant af usikker betydning (VUS) |
| `likely_benign`, `benign` | Ikke sygdomsfremkaldende |
| `high_risk`, `moderate_risk`, `low_risk` | Klassificering af risikoniveau |
| `protective` | Beskyttende variant |
| `drug_response`, `poor_metabolizer`, `rapid_metabolizer` | Farmakogenomiske fund |

### Statusser for genetiske resultater

| Status | Betydning |
| - | - |
| `planned` | Testen er bestilt, men resultaterne er ikke kommet endnu. |
| `received` | Laboratoriet har returneret et resultat. |
| `likely_wrong` | Anivas automatiske tjek eller medlemmet tvivler på genotypen. Ikke bekræftet. Se `status_reason`. |
| `fault` | Laboratoriet leverede et resultat, der er bekræftet forkert — **må ikke bruges klinisk**. Se `status_reason`. |
| `undeliverable` | Laboratoriet kunne ikke bestemme en genotype. Se `status_reason`. |

### Variantstruktur

Hvert genetisk resultat indeholder et `variants`-array. Hver variant omfatter:

* **`name`** — almindeligt navn (f.eks. APOE E4).
* **`clinical_significance`** — betydning på variantniveau (kan afvige fra betydningen på genniveau).
* **`conditions`** — tilknyttede sygdomme/tilstande med beskrivelser.
* **`snvs`** — de underliggende enkeltnukleotidvarianter, hver med `rs_id`, `allele`, `reference_allele` og valgfri HGVS-notation.

## Dokumenter

Arrayet `documents` i resultatsvaret indeholder referencer til laboratorierapportfiler, der kan downloades. Hvert dokument har:

* **`id`** — en fil-UUID. Send denne til `GET /api/v1/documents/{id}` for at downloade filen.
* **`file_name`** — filnavnet, det samme som downloadet sender (f.eks. `20260405 - Quade Befund - 7642001234.pdf`).
* **`original_file_name`** — filnavnet præcis som laboratoriet eller uploaderen leverede det (f.eks. `7642001234_B0012_FA_E.pdf`).
* **`origin`** — hvem der leverede filen: `lab`, `member_upload`, `staff_upload` eller `partner_upload` (du uploadede den med [Upload dokument](https://docs.anivahealth.com/da/api/documents/upload-document.md)).
* **`content_type`** — filens medietype (f.eks. `application/pdf`). De fleste rapporter er PDF'er. Uploadede scanninger kan være billeder eller CSV-filer.
* **`etag`** — versionen af filindholdet; den ændres, hver gang bytene ændres. Gem den, og download kun igen, når den ændres. Det er et standard HTTP entity tag, som bruges af S3 eller Google Cloud Storage.
* **`size_bytes`** — filstørrelsen i bytes.
* **`lab_code`** — laboratoriekoden (prøveglassets stregkode), som rapporten tilhører; `null`, når laboratoriet ikke har angivet nogen.

> [!NOTE]
>
> Adgang til dokumenter valideres mod den profil, der ejer dokumentet.

## Send resultater til kunden på e-mail

Du kan give kunden besked på e-mail om, at resultaterne er klar. Kald
[Send resultater på e-mail](https://docs.anivahealth.com/da/api/appointments/email-results.md) for en tid eller
[Send resultater på e-mail](https://docs.anivahealth.com/da/api/home-kit-orders/email-results.md) for en hjemmetestkitordre. Hvert kald sender én e-mail.
Kald deduplikeres ikke.

* E-mailen sendes til profilens `email`. En pladsholderadresse med `@aniva.email` afvises.
* E-mailen viser navnet og logoet for profilens primære profilgruppe.
* E-mailen er på profilens `language`, engelsk som standard.
* Sæt `with_reports` til `true` for at vedhæfte laboratorierapporterne.
* Tilføj `note` for at vise en personlig note i e-mailen, højst 1.000 tegn.

Hvis profilen har slået transaktionelle e-mails fra, returnerer kaldet `409` med årsagen
`unsubscribed`. For at slå dem til igen skal du sætte `transactional_emails_enabled` til `true` med
[Opdater profil](https://docs.anivahealth.com/da/api/profiles/update-profile.md).

## E-mails, når resultater er klar

Du kan få en e-mail, når resultaterne for en booking er klar. Sæt `results_ready_emails` til op til 5
adresser i [Opret tid](https://docs.anivahealth.com/da/api/appointments/create-appointment.md) eller
[Opret hjemmetestkitordre](https://docs.anivahealth.com/da/api/home-kit-orders/create-home-kit.md). Rediger listen senere med
[Opdater tid](https://docs.anivahealth.com/da/api/appointments/update-appointment.md) eller
[Opdater hjemmetestkitordre](https://docs.anivahealth.com/da/api/home-kit-orders/update-home-kit.md); `[]` slår e-mailsene fra.

* Bed os om at angive standard-e-mailadresser for din profilgruppe. En booking oprettet uden
  `results_ready_emails` får dem. En liste erstatter dem for den pågældende booking, så medtag din
  standard-e-mailadresse for at beholde den. `[]` sender ingen e-mail.
* Hver adresse får én e-mail, når alle laboratorieresultater for bookingen er endelige.
* En adresse, der tilføjes, efter at resultaterne er endelige, får e-mailen med det samme.
* E-mailen linker til resultatsiden i Anivas adminpanel. Kunden modtager den ikke.
* Din nøgle skal have `results_view`-adgang til patienten. Uden den returnerer forespørgslen `403`.

## Vis resultater i din app

[Opret embed-session](https://docs.anivahealth.com/da/api/profiles/create-embed-session.md) returnerer en engangs-URL til en skrivebeskyttet
resultatside. Åbn den i en WebView i din app, så patienten ser resultaterne uden at logge ind.

* Din nøgle skal have `embed`- og `results_view`-scopes for patienten. Bed Aniva om
  `embed`-scopet.
* Kald den fra din server, hver gang patienten åbner resultaterne. URL'en virker én gang og i
  5 minutter, og siden holder derefter en 60-minutters session.
* `route` åbner en af de sider, vi frigiver: biomarkørlisten, én biomarkør eller 3D Twin.
* `appearance` styrer temaet, farven på knapper og links, og om dit logo vises.
* `report` begrænser siden til én tid, én hjemmetestkitordre eller én laboratorierapport, som du
  har uploadet med `POST /api/v1/documents`. Patienten ser derefter kun resultaterne fra den rapport.
* Siden viser kun laboratorieresultater, ligesom dette API. Den viser ingen filer, ingen chat og ingen indstillinger.

## Eksempel på resultatsvar

```json theme={null}
{
  "status": "in_progress",
  "submissions": [
    {
      "lab_code": "7642001234",
      "status": "in_progress"
    }
  ],
  "clinical_results": [
    {
      "id": "3f2b8c1e-5d4a-4e7b-9a6c-2d1f0e8b7a54",
      "status": "received",
      "status_reason": null,
      "lab_code": "7642001234",
      "biomarker_id": 104,
      "biomarker_name": "Vitamin D",
      "category": "Vitamins",
      "value": 38.5,
      "value_operator": "eq",
      "unit_id": 1,
      "unit": "ng/mL",
      "reference_range_lab": {
        "normal_min": 30,
        "normal_max": 100,
        "optimal_min": null,
        "optimal_max": null
      },
      "reference_range_lab_absent_reason": null,
      "aniva_range": {
        "normal_min": 30,
        "normal_max": 100,
        "optimal_min": 30,
        "optimal_max": 60,
        "sources": [
          {
            "title": "Example source title",
            "url": "https://example.com/source"
          }
        ]
      },
      "tested_at": "2026-04-05",
      "comment": null,
      "origin": "lab",
      "lab_reported": {
        "name": "Vitamin D (25-OH)",
        "code": "vitd",
        "category": "Endokrinologie",
        "value": "38.5",
        "unit": "ng/ml",
        "reference_range": "30 - 100",
        "reference_range_min": 30,
        "reference_range_max": 100,
        "flag": "normal",
        "result_status": "final",
        "comment": null
      }
    },
    {
      "id": null,
      "status": "planned",
      "status_reason": null,
      "lab_code": null,
      "biomarker_id": 79,
      "biomarker_name": "Thyroid-Stimulating Hormone (TSH)",
      "category": "Hormones",
      "value": null,
      "value_operator": null,
      "unit_id": null,
      "unit": null,
      "reference_range_lab": null,
      "reference_range_lab_absent_reason": null,
      "aniva_range": null,
      "tested_at": null,
      "comment": null,
      "origin": null,
      "lab_reported": null
    }
  ],
  "genetic_results": [
    {
      "id": "b7e41d09-2c6f-4a83-8f15-6e9d3a0c4b21",
      "status": "received",
      "status_reason": null,
      "lab_code": "7642001234",
      "biomarker_id": 348,
      "gene": "APOE",
      "genotype": "E3/E4",
      "clinical_significance": "moderate_risk",
      "risk_description": "Carriers of one APOE E4 allele have a moderately increased risk of Alzheimer's disease.",
      "tested_at": "2026-04-05",
      "comment": null,
      "origin": "lab",
      "variants": [
        {
          "name": "APOE E4",
          "clinical_significance": "moderate_risk",
          "description": "The E4 allele is associated with increased Alzheimer's risk.",
          "hgvs_c": "c.388T>C",
          "hgvs_p": "p.Cys130Arg",
          "conditions": [
            {
              "condition": "Alzheimer's disease",
              "association_description": "Increased risk with one E4 allele",
              "badge": "Moderate Risk"
            }
          ],
          "snvs": [
            {
              "rs_id": "rs429358",
              "allele": "C",
              "reference_allele": "T",
              "hgvs_c": "c.388T>C",
              "hgvs_p": "p.Cys130Arg"
            }
          ]
        }
      ]
    }
  ],
  "documents": [
    {
      "id": "f8a1b2c3-d4e5-4f6a-7b8c-9d0e1f2a3b4c",
      "file_name": "20260405 - Quade Befund - 7642001234.pdf",
      "original_file_name": "7642001234_B0012_FA_E.pdf",
      "origin": "lab",
      "content_type": "application/pdf",
      "etag": "56104b36f860cfd5b41efc716fdf7b6f",
      "size_bytes": 258341,
      "lab_code": "7642001234"
    }
  ]
}
```


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