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

# Hent laboratorieresultater

> Hent kliniske og genetiske laboratorieresultater for en ordre på hjemmetestkit

Hent kliniske og genetiske laboratorieresultater for en hjemmetestkitordre samt dokumentreferencer til laboratorierapporter i PDF-format.

Hver biomarkør, der er bestilt til kittet, vises i svaret, så du kan følge hele ordren og ikke kun det, der er kommet retur. Resultaterne registreres under ordrens `lab_code` — laboratorieordren oprettes ved [aktivering](https://docs.anivahealth.com/da/api/home-kit-orders/activate-home-kit.md), og laboratoriet indberetter markørerne enkeltvis, efterhånden som de analyseres, så et delvist svar er normalt, og den overordnede `status` forbliver `in_progress` indtil den endelige rapport. Læs `status` på hvert resultat, før du bruger dets `value`:

* Tests, der stadig afventer svar, vises med status `planned`, mens ordren er `in_progress`. Du kan kalde dette endpoint før aktivering — alle bestilte markører har da status `planned`.
* Resultater, som laboratoriet har leveret, men som **ikke** må bruges klinisk, vises med status `fault` eller `undeliverable` og har en `status_reason`, der forklarer hvorfor. Et `fault`-resultat har stadig sin `value` udfyldt — den værdi er forkert. Vis den aldrig som et fund.
* Resultater, som Aniva eller medlemmet betvivler, vises med status `likely_wrong` og en `status_reason`. Værdien er ikke bekræftet. Vis den ikke som et fund uden gennemgang.

Brug [Download dokument](https://docs.anivahealth.com/da/api/documents/download-document.md) til at downloade PDF-laboratorierapporter, der henvises til i arrayet `documents`.

Du behøver ikke at polle dette endpoint. Abonner på [webhooks](https://docs.anivahealth.com/da/concepts/webhooks.md) for `home_kit_order.results.updated` eller `home_kit_order.results.completed`, og kald det, når du modtager en hændelse. Polling fungerer stadig som reserveløsning.

Kræver scopet `results_view` — laboratorieresultater og dokumenter er altid beskyttet af det, ligesom resultater fra tider og [Download dokument](https://docs.anivahealth.com/da/api/documents/download-document.md) — plus scopet `home_kit_orders_view` eller `home_kit_orders_manage` for at få adgang til selve kitordren.

## Forespørgsel

### Stiparametre

**id** `string` *required*

Unik identifikator (UUID) for hjemmetestkitordren, der skal hentes resultater for.

## Svar

Ved succes returnerer API'et `200 OK` med resultatobjektet.

**status** `string` *required*

Samlet status for resultaterne. En af følgende:

* `in_progress` — nogle rekvisitioner er stadig hos laboratoriet.
* `completed` — alle rekvisitioner er afsluttet, og mindst én har rapporteret.
* `fault` — alle rekvisitioner fejlede uden at rapportere. Der udestår intet.

**submissions** `object[]` *required*

Én post pr. laboratorierekvisition — en blodprøvetagning fordelt på flere prøveglas eller laboratorier har
flere. Den overordnede `status` er `completed`, når alle poster er afsluttet, og én har rapporteret.

**submission-objekt**

**lab\_code** `string`

Laboratoriekode (stregkode på prøveglasset), som denne rekvisition blev registreret under. Kan være `null`, når laboratoriet ikke registrerede
nogen.

**status** `string` *required*

`in_progress`, mens laboratoriet stadig arbejder på den, `completed`, når rapporten er
endelig, eller `fault`, når rekvisitionen blev afvist eller opgivet og aldrig vil rapportere —
prøven flyttes ofte til et andet laboratorium, som derefter opretter sin egen post.

**clinical\_results** `object[]` *required*

Array af kliniske biomarkørresultater.

**klinisk resultatobjekt**

**id** `string`

Id for laboratorieresultatrækken (UUID). Det forbliver det samme, når laboratoriet retter rækken, så brug det til upsert. `null` for et `planned`-resultat.

**status** `string` *required*

Resultatstatus. En af:

* `planned` — bestilt, ikke returneret fra laboratoriet endnu. `value` er `null`.
* `received` — leveret af laboratoriet.
* `corrected` — leveret og derefter rettet af et menneske. `value` er den rettede værdi.
* `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` — leveret, men bekræftet forkert; **må ikke bruges klinisk**. `value` er udfyldt med det forkerte tal. Se `status_reason`.
* `undeliverable` — laboratoriet kunne ikke producere en værdi. `value` er `null`. Se `status_reason`.

**status\_reason** `string` *required*

Hvorfor resultatet er tvivlsomt eller ubrugeligt. Udfyldt for `likely_wrong`, `fault` og `undeliverable`, `null` for alle andre statusser.

Adskiller sig fra `comment`, som er laboratoriets egen note på rapporten — `comment` er tom ved de fleste fejlbehæftede resultater, så brug `status_reason` som den autoritative forklaring.

**lab\_code** `string`

Laboratoriekode (rørets stregkode), som resultatet blev registreret under — en af ordrens laboratoriekoder. `null` for et `planned`-resultat og for resultater, som laboratoriet rapporterede uden kode.

**biomarker\_id** `integer` *required*

Biomarkør-id.

**biomarker\_name** `string` *required*

Visningsnavn for biomarkør.

**category** `string`

Biomarkørkategori (f.eks. hormoner, vitaminer). Kan være `null`.

**value** `number`

Gældende resultatværdi (rettet hvis tilgængelig, ellers rå). Kan være `null`.

**value\_operator** `string`

Sammenligningsoperator for værdien: `eq` (lig med), `lt` (mindre end) eller `gt` (større end). Kan være `null`.

**unit\_id** `integer`

Måleenheds-id. Kan være `null`.

**unit** `string`

Visningsnavn for måleenhed. Kan være `null`.

**reference\_range\_lab** `object`

Referenceintervaller rapporteret af laboratoriet for **dette** resultat, omregnet til samme enhed som `value`. `null`, når laboratoriet ikke rapporterede noget interval.

En grænse, som laboratoriet lod stå åben, forbliver `null`, så et ensidigt interval kun udfylder sin egen ende — en øvre grænseværdi kommer som `normal_min: null, normal_max: 50`, en nedre som `normal_min: 55, normal_max: null`. Læs ikke en `null`-grænse som nul eller som ubegrænset som standard; læs den som "laboratoriet satte ingen grænse på den side".

Hvert resultat har det interval med, som det blev målt op imod, så en patient, hvis resultater spænder over flere blodprøvetagninger eller flere laboratorier, får det rigtige interval pr. resultat i stedet for det seneste.

**referenceinterval**

**normal\_min** `number`

Nedre grænse for normalintervallet. Kan være `null`.

**normal\_max** `number`

Øvre grænse for normalintervallet. Kan være `null`.

**optimal\_min** `number`

Nedre grænse for det optimale interval. Kan være `null`.

**optimal\_max** `number`

Øvre grænse for det optimale interval. Kan være `null`.

**reference\_range\_lab\_absent\_reason** `string`

Hvorfor `reference_range_lab` er `null`. `null`, når `reference_range_lab` er angivet, og ved et `planned`-resultat.

* `not_provided`: der findes intet interval. Laboratoriet sendte intet. Vis "Ikke relevant".
* `lab_text_only`: laboratoriet skrev kun tekst, f.eks. et mål, et risikoniveau eller et interval for en livsfase. Vis `lab_reported.reference_range`.
* `not_measured`: resultatet er `undeliverable`, så der er ingen værdi at sammenligne med. Vis `status_reason`.

**aniva\_range** `object`

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

**referenceinterval**

**normal\_min** `number`

Nedre grænse for normalintervallet. Kan være `null`.

**normal\_max** `number`

Øvre grænse for normalintervallet. Kan være `null`.

**optimal\_min** `number`

Nedre grænse for det optimale interval. Kan være `null`.

**optimal\_max** `number`

Øvre grænse for det smallere interval. Kan være `null`.

**sources** `object[]`

Publicerede kilder, som Aniva har registreret for disse værdier. Hvert element har en `title` og en `url`. `url` kan være `null`. Listen er tom, når Aniva ikke har registreret nogen kilde.

**tested\_at** `string`

Datoen hvor testen blev udført i formatet `YYYY-MM-DD`. Kan være `null`.

**comment** `string`

Valgfri kommentar til resultatet. Kan være `null`.

**origin** `string`

Hvem der leverede dokumentet, som denne værdi kommer fra, svarende til `origin` på dokumentet. En værdi fra et uploadet dokument kommer fra Anivas aflæsning af filen, ikke fra en laboratorierapport. `null` for et `planned`-resultat.

**lab\_reported** `object`

Det udførende laboratoriums egen rapportlinje, ordret — til at sammenholde denne payload med laboratoriets PDF. Kan være `null`, når vi ikke har nogen rå registrering for resultatet.

Alle andre felter på et resultat er normaliserede: `value` og `unit` er omregnet til biomarkørens standardenhed, og `biomarker_name` er vores navn for analytten, ikke laboratoriets. Felterne nedenfor er ikke. Brug dem som den trykte reference og de kanoniske felter som konsistenstjek.

Tallene her er laboratoriets egne grænser på laboratoriets egen skala — `reference_range_min` og `reference_range_max` er **ikke** enhedsomregnede og vil afvige fra `reference_range_lab`, hvor de to skalaer er forskellige. En grænse, som laboratoriet lod stå åben, forbliver `null`; intet udledes eller sættes som standard.

**rapporteret af laboratoriet**

**name** `string`

Analytnavn som trykt af laboratoriet. Kan være `null`.

**code** `string`

Laboratoriets egen analytkode. Kan være `null`.

**category** `string`

Afsnitsoverskrift i rapporten, f.eks. `Klinische Chemie`. Kan være `null`.

**value** `string`

Værdi som trykt. En streng, så ikke-numeriske resultater bevares uændret (`<0.04`, `negativ`, `1:100`). Kan være `null`.

**unit** `string`

Enhed som trykt, f.eks. `U/l`. Kan være `null`.

**reference\_range** `string`

Referenceinterval som trykt, inklusive ensidige grænseværdier: `40 - 129`, `< 50`, `> 55`. Kan være `null`.

**reference\_range\_min** `number`

Laboratoriets nedre grænse, ikke omregnet. `null` for et interval, som laboratoriet lod stå åbent nedadtil.

**reference\_range\_max** `number`

Laboratoriets øvre grænse, ikke omregnet. `null` for et interval, som laboratoriet lod stå åbent opadtil.

**flag** `string`

Laboratoriets afvigelsesmarkering for denne linje: `normal`, `high`, `low`, `critical_high`, `critical_low`, `abnormal`. En kode, vi ikke genkender, sendes videre, som laboratoriet leverede den. Kan være `null`.

**result\_status** `string`

Laboratoriets resultatstatus: `final`, `preliminary`, `correction`, `incomplete`, `partial`, `deleted`, `cannot_be_obtained`. En `preliminary`-værdi kan stadig ændres. En senere [webhook](https://docs.anivahealth.com/da/concepts/webhooks.md) for `results.updated` giver dig besked om, hvornår du skal hente igen. Kan være `null`.

**comment** `string`

Laboratoriets egen note på denne linje. Kolonnemellemrum er sammentrukket; ordlyden er uændret. Kan være `null`.

**genetic\_results** `object[]` *required*

Array af genetiske biomarkørresultater.

**genetisk resultatobjekt**

**id** `string`

Id for laboratorieresultatrækken (UUID). Det forbliver det samme, når laboratoriet retter rækken, så brug det til upsert. `null` for et `planned`-resultat.

**status** `string` *required*

Resultatstatus. En af:

* `planned` — bestilt, ikke returneret fra laboratoriet endnu.
* `received` — leveret af laboratoriet.
* `likely_wrong` — Anivas automatiske tjek eller medlemmet betvivler genotypen. Ikke bekræftet. Se `status_reason`.
* `fault` — leveret, men bekræftet forkert; **må ikke bruges klinisk**. Se `status_reason`.
* `undeliverable` — laboratoriet kunne ikke producere en genotype. Se `status_reason`.

**status\_reason** `string` *required*

Hvorfor resultatet er tvivlsomt eller ubrugeligt. Udfyldt for `likely_wrong`, `fault` og `undeliverable`, `null` for alle andre statusser.

**lab\_code** `string`

Laboratoriekode (rørets stregkode), som resultatet blev registreret under. `null` for et `planned`-resultat og for resultater, som laboratoriet rapporterede uden kode.

**biomarker\_id** `integer` *required*

Biomarkør-id (gen).

**gene** `string` *required*

Gensymbol (f.eks. APOE, MTHFR).

**genotype** `string`

Genotypevisning (f.eks. E3/E4). Kan være `null`.

**clinical\_significance** `string`

Samlet klinisk betydning. En af `pathogenic`, `likely_pathogenic`, `uncertain`, `likely_benign`, `benign`, `high_risk`, `moderate_risk`, `low_risk`, `protective`, `drug_response`, `poor_metabolizer` eller `rapid_metabolizer`. Kan være `null`.

**risk\_description** `string`

Risikobeskrivelse for denne genotype. Kan være `null`.

**tested\_at** `string`

Datoen hvor testen blev udført i formatet `YYYY-MM-DD`. Kan være `null`.

**comment** `string`

Valgfri kommentar til resultatet. Kan være `null`.

**origin** `string`

Hvem der leverede dokumentet, som denne værdi kommer fra, svarende til `origin` på dokumentet. En værdi fra et uploadet dokument kommer fra Anivas aflæsning af filen, ikke fra en laboratorierapport. `null` for et `planned`-resultat.

**variants** `object[]` *required*

Påviste genetiske varianter.

**variantobjekt**

**name** `string` *required*

Almindeligt navn på varianten (f.eks. APOE E4).

**clinical\_significance** `string`

Klinisk betydning på variantniveau. Kan være `null`.

**description** `string`

Beskrivelse af varianten. Kan være `null`.

**hgvs\_c** `string`

HGVS-notation for kodende DNA. Kan være `null`.

**hgvs\_p** `string`

HGVS-notation for protein. Kan være `null`.

**conditions** `object[]` *required*

Tilknyttede tilstande.

**tilstandsobjekt**

**condition** `string` *required*

Navn på tilstand/sygdom.

**association\_description** `string`

Beskrivelse af sammenhængen mellem variant og tilstand. Kan være `null`.

**badge** `string`

Kort badgetekst til visning. Kan være `null`.

**snvs** `object[]` *required*

Enkeltnukleotidvarianter, der definerer denne variant.

**SNV-objekt**

**rs\_id** `string` *required*

dbSNP-id (f.eks. rs429358).

**allele** `string` *required*

Variantallel (`A`, `C`, `G`, `T`, `del`, `ins` eller `undetermined`).

**reference\_allele** `string` *required*

Referenceallel i populationen.

**hgvs\_c** `string`

HGVS-notation for kodende DNA. Kan være `null`.

**hgvs\_p** `string`

HGVS-notation for protein. Kan være `null`.

**documents** `object[]` *required*

Dokumenter med laboratorierapporter. Brug `GET /api/v1/documents/{id}` til at downloade hver fil.

**dokumentobjekt**

**id** `string` *required*

Fil-id (UUID). Send det til [Download dokument](https://docs.anivahealth.com/da/api/documents/download-document.md) for at hente filen.

**file\_name** `string` *required*

Filnavn. [Download dokument](https://docs.anivahealth.com/da/api/documents/download-document.md) sender det samme navn i `Content-Disposition`. Det indeholder en dato, dokumentets titel og laboratoriekoden, f.eks. `20260405 - Quade Befund - 7642001234.pdf`. Brug det kun til visning. Læs laboratoriekoden fra `lab_code`, ikke fra navnet.

**original\_file\_name** `string` *required*

Filnavnet præcis som kilden leverede det, f.eks. `7642100312_B0012_FA_V.pdf` fra laboratoriet eller medlemmets eget navn ved en upload. Aniva ændrer det ikke.

**origin** `string` *required*

Hvem der leverede filen. En af `lab` (laboratoriet sendte den), `member_upload` (medlemmet uploadede den), `staff_upload` (Aniva-personale uploadede den) eller `partner_upload` (du uploadede den med [Upload dokument](https://docs.anivahealth.com/da/api/documents/upload-document.md)).

**content\_type** `string` *required*

Filens medietype, f.eks. `application/pdf`, `image/jpeg` eller `text/csv`. De fleste laboratorierapporter er PDF-filer.

**etag** `string`

Version af filindholdet. Den ændrer sig, hver gang bytene ændrer sig, så sammenlign den med din gemte værdi for at se, om du skal downloade igen. [Download dokument](https://docs.anivahealth.com/da/api/documents/download-document.md) sender den i anførselstegn som den almindelige HTTP-header `ETag`. Kan være `null`, når den gemte fil mangler.

**size\_bytes** `integer`

Filstørrelse i bytes. Kan være `null`, når den gemte fil mangler.

**lab\_code** `string`

Laboratoriekode (rørets stregkode), som rapporten tilhører. Kan være `null`, når laboratoriet ikke har angivet nogen.

## Gentagne kald

Aniva gemmer svaret fra dette endpoint i 60 minutter for hver API-nøgle. Et gentaget kald inden for
dette tidsrum får det gemte svar, så længe hjemmetestkitordren og dens resultater er uændrede. Efter en ændring får du et nyt
svar. Headerne `Cache-Status` og `Age` viser, at svaret er
gemt, og hvor gammelt det er.

For at få besked om en ændring med det samme kan du abonnere på webhook-hændelserne `home_kit_order.results.updated`, `home_kit_order.results.completed` og `home_kit_order.results.fault`.
Se [Gentagne læsninger](https://docs.anivahealth.com/da/concepts/webhooks.md#gentagne-laesninger).

## Fejlsvar

| Status | Beskrivelse |
| - | - |
| `400` | Ugyldigt ID-format — den angivne værdi er ikke en gyldig UUID. |
| `403` | Ingen adgang — din API-nøgle mangler scopet `results_view`, mangler både `home_kit_orders_view` og `home_kit_orders_manage`, eller hjemmetestkitordren ligger uden for din adgangskontekst. |
| `404` | Hjemmetestkitordren blev ikke fundet. |
| `500` | Intern serverfejl. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/home-kit-orders/d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a/results \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "status": "in_progress",
  "submissions": [
    {
      "lab_code": "7642001234",
      "status": "in_progress"
    }
  ],
  "clinical_results": [
    {
      "id": "e9f1a3c5-6b7d-4c2e-8a4f-1d3b5c7e9f02",
      "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": "1b3d5f7a-9c2e-4a6b-8d0f-2e4a6c8b0d13",
      "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"
    }
  ]
}
```

```json 404 theme={null}
{
  "error": "Home kit order not found"
}
```


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