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

> Hent kliniske og genetiske labresultater for en time

Hent kliniske og genetiske laboratorieresultater for en time, sammen med dokumentreferanser for PDF-er med laboratorierapporter.

Hver biomarkør som er bestilt for timen, vises i svaret, slik at du kan følge hele bestillingen og ikke bare det som har kommet tilbake. Les `status` på hvert resultat før du bruker `value`:

* Prøver som fortsatt gjenstår, vises med status `planned` mens timen er `in_progress`.
* Resultater som laboratoriet har levert, men som **ikke** må brukes klinisk, vises med status `fault` eller `undeliverable`, og har en `status_reason` som forklarer hvorfor. Et `fault`-resultat har fortsatt `value` fylt ut – den verdien er feil. Presenter den aldri som et funn.
* Resultater som Aniva eller medlemmet er i tvil om, vises med status `likely_wrong` og en `status_reason`. Verdien er ikke bekreftet. Ikke vis den som et funn uten gjennomgang.

Hvert mottatt resultat og dokument har `lab_code` (strekkode på prøverøret) som det ble registrert under, og `submissions`-arrayet lister opp hver laboratorierekvisisjon fra blodprøvetakingen med egen status – en blodprøvetaking fordelt på flere prøverør eller laboratorier fullføres rekvisisjon for rekvisisjon.

Bruk [Last ned dokument](https://docs.anivahealth.com/no/api/documents/download-document.md) for å laste ned PDF-er med laboratorierapporter som det vises til i `documents`-arrayet.

Du trenger ikke polle dette endepunktet. Abonner på [webhooks](https://docs.anivahealth.com/no/concepts/webhooks.md) for `appointment.results.updated` eller `appointment.results.completed`, og kall endepunktet når en hendelse kommer inn. Polling fungerer fortsatt som reserveløsning.

Krever scopet `results_view`.

## Forespørsel

### Stiparametere

**id** `string` *required*

Unik identifikator (UUID) for timen det skal hentes resultater for.

## Respons

Ved suksess returnerer API-et `200 OK` med resultatobjektet.

**status** `string` *required*

Samlet status for resultatene. En av:

* `in_progress` – noen rekvisisjoner er fortsatt hos laboratoriet.
* `completed` – alle rekvisisjoner er avsluttet og minst én har rapportert.
* `fault` – alle rekvisisjoner feilet uten å rapportere. Ingenting utestår.

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

Én oppføring per laboratorierekvisisjon – en blodprøvetaking fordelt på flere prøverør eller laboratorier har
flere. Toppnivåets `status` er `completed` når alle oppføringer er avsluttet og én har rapportert.

**submission-objekt**

**lab\_code** `string`

Laboratoriekode (strekkode på prøverøret) denne rekvisisjonen ble registrert under. Kan være `null` når laboratoriet ikke registrerte
noen.

**status** `string` *required*

`in_progress` mens laboratoriet fortsatt jobber med den, `completed` når rapporten er
endelig, eller `fault` når rekvisisjonen ble avvist eller avbrutt og aldri vil rapportere –
prøven flyttes ofte til et annet laboratorium, som deretter registrerer sin egen oppføring.

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

Liste med kliniske biomarkørresultater.

**klinisk resultatobjekt**

**id** `string`

ID for raden med labresultat (UUID). Den forblir den samme når laboratoriet korrigerer raden, så bruk den til upsert. `null` for et `planned`-resultat.

**status** `string` *required*

Resultatstatus. En av:

* `planned` — bestilt, ikke returnert fra laboratoriet ennå. `value` er `null`.
* `received` — levert av laboratoriet.
* `corrected` — levert og deretter rettet av et menneske. `value` er den korrigerte verdien.
* `likely_wrong` — Anivas automatiske kontroll eller medlemmet tviler på verdien. Ikke bekreftet: ikke vis den som et funn uten gjennomgang. Se `status_reason`.
* `fault` — levert, men bekreftet feil; **må ikke brukes klinisk**. `value` inneholder feil tall. Se `status_reason`.
* `undeliverable` — laboratoriet kunne ikke produsere en verdi. `value` er `null`. Se `status_reason`.

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

Hvorfor resultatet er tvilsomt eller ubrukelig. Utfylt for `likely_wrong`, `fault` og `undeliverable`, `null` for alle andre statuser.

Skiller seg fra `comment`, som er laboratoriets eget notat i rapporten — `comment` er tomt på de fleste resultater med feil, så behandle `status_reason` som den gjeldende forklaringen.

**lab\_code** `string`

Labkode (strekkode på prøverøret) resultatet ble registrert under — en av bestillingens labkoder. `null` for et `planned`-resultat og for resultater laboratoriet rapporterte uten kode.

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

Biomarkør-ID.

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

Visningsnavn for biomarkøren.

**category** `string`

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

**value** `number`

Gjeldende resultatverdi (korrigert hvis tilgjengelig, ellers råverdi). Kan være `null`.

**value\_operator** `string`

Sammenligningsoperator for verdien: `eq` (lik), `lt` (mindre enn) eller `gt` (større enn). Kan være `null`.

**unit\_id** `integer`

ID for måleenhet. Kan være `null`.

**unit** `string`

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

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

Referanseområder rapportert av laboratoriet for **dette** resultatet, konvertert til samme enhet som `value`. `null` når laboratoriet ikke rapporterte noe område.

En grense laboratoriet lot stå åpen, forblir `null`, så et ensidig intervall fyller bare ut sin egen ende — en øvre grense kommer som `normal_min: null, normal_max: 50`, og en nedre som `normal_min: 55, normal_max: null`. Ikke tolk en `null`-grense som 0 eller ubegrenset som standard; tolk den som "laboratoriet satte ingen grense på den siden".

Hvert resultat har med seg området det ble målt mot, slik at en pasient med resultater fra flere blodprøvetakinger eller flere laboratorier får riktig intervall per resultat i stedet for det nyeste.

**referanseområde**

**normal\_min** `number`

Nedre grense for normalt område. Kan være `null`.

**normal\_max** `number`

Øvre grense for normalt område. Kan være `null`.

**optimal\_min** `number`

Nedre grense for optimalt område. Kan være `null`.

**optimal\_max** `number`

Øvre grense for optimalt område. Kan være `null`.

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

Hvorfor `reference_range_lab` er `null`. `null` når `reference_range_lab` finnes, og på et `planned`-resultat.

* `not_provided`: det finnes ikke noe område. Laboratoriet sendte ikke noe. Vis "Ikke aktuelt".
* `lab_text_only`: laboratoriet skrev bare ut tekst, for eksempel en målverdi, et risikonivå eller et område knyttet til livsfase. Vis `lab_reported.reference_range`.
* `not_measured`: resultatet er `undeliverable`, så det finnes ingen verdi å sammenligne. Vis `status_reason`.

**aniva\_range** `object`

Sammenligningsverdier som Aniva har satt sammen, på samme skala som `value`. De varierer etter alder, kjønn og svangerskapsuke. `normal_*` er det generelle området. `optimal_*` er et smalere område. Verdiene er kun ment som informasjon. De er ikke medisinske råd, ikke en diagnose og ikke en vurdering av resultatet. Aniva setter ingen flagg mot dem. Bruk `reference_range_lab` som standard for resultatet. `null` når nøkkelen din ikke har scope `aniva_ranges_view`, eller når Aniva ikke har verdier for denne biomarkøren.

**referanseområde**

**normal\_min** `number`

Nedre grense for normalt område. Kan være `null`.

**normal\_max** `number`

Øvre grense for normalt område. Kan være `null`.

**optimal\_min** `number`

Nedre grense for optimalt område. Kan være `null`.

**optimal\_max** `number`

Øvre grense for det smalere området. Kan være `null`.

**sources** `object[]`

Publiserte kilder som Aniva har registrert for disse verdiene. Hver oppføring har en `title` og en `url`. `url` kan være `null`. Listen er tom når Aniva ikke har registrert noen kilde.

**tested\_at** `string`

Datoen testen ble utført i `YYYY-MM-DD`-format. Kan være `null`.

**comment** `string`

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

**origin** `string`

Hvem som leverte dokumentet denne verdien kommer fra, tilsvarende `origin` på dokumentet. En verdi fra et opplastet dokument kommer fra at Aniva leser filen, ikke fra en laboratorierapport. `null` for et `planned`-resultat.

**lab\_reported** `object`

Det utførende laboratoriets egen rapportlinje, ordrett — for å lese denne payloaden opp mot laboratoriets PDF. Kan være `null` når vi ikke har noen råoppføring for resultatet.

Alle andre felt på et resultat er normalisert: `value` og `unit` er konvertert til biomarkørens standardenhet, og `biomarker_name` er vårt navn på analytten, ikke laboratoriets. Feltene nedenfor er ikke det. Behandle dem som referanse slik det ble skrevet ut, og de kanoniske feltene som kryssjekk for konsistens.

Tallene her er laboratoriets egne grenser på laboratoriets egen skala — `reference_range_min` og `reference_range_max` er **ikke** enhetskonvertert og vil skille seg fra `reference_range_lab` der de to skalaene er ulike. En grense laboratoriet lot stå åpen, forblir `null`; ingenting utledes eller settes som standard.

**rapportert av laboratoriet**

**name** `string`

Analyttnavn slik det ble skrevet ut av laboratoriet. Kan være `null`.

**code** `string`

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

**category** `string`

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

**value** `string`

Verdi slik den ble skrevet ut. En tekststreng, slik at ikke-numeriske resultater beholdes uendret (`<0.04`, `negativ`, `1:100`). Kan være `null`.

**unit** `string`

Enhet slik den ble skrevet ut, f.eks. `U/l`. Kan være `null`.

**reference\_range** `string`

Referanseintervall slik det ble skrevet ut, inkludert ensidige grenser: `40 - 129`, `< 50`, `> 55`. Kan være `null`.

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

Laboratoriets nedre grense, ukonvertert. `null` for et intervall laboratoriet lot stå åpent nedover.

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

Laboratoriets øvre grense, ukonvertert. `null` for et intervall laboratoriet lot stå åpent oppover.

**flag** `string`

Laboratoriets avviksflagg for denne linjen: `normal`, `high`, `low`, `critical_high`, `critical_low`, `abnormal`. En kode vi ikke gjenkjenner, sendes videre slik laboratoriet sendte den. Kan være `null`.

**result\_status** `string`

Laboratoriets resultatstatus: `final`, `preliminary`, `correction`, `incomplete`, `partial`, `deleted`, `cannot_be_obtained`. En `preliminary`-verdi kan fortsatt endres. En senere `results.updated`-[webhook](https://docs.anivahealth.com/no/concepts/webhooks.md) gir deg beskjed når du skal hente på nytt. Kan være `null`.

**comment** `string`

Laboratoriets eget notat for denne linjen. Ekstra mellomrom fra kolonner er fjernet; ordlyden er urørt. Kan være `null`.

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

Liste med genetiske biomarkørresultater.

**genetisk resultatobjekt**

**id** `string`

ID for raden med labresultat (UUID). Den forblir den samme når laboratoriet korrigerer raden, så bruk den til upsert. `null` for et `planned`-resultat.

**status** `string` *required*

Resultatstatus. En av:

* `planned` — bestilt, ikke returnert fra laboratoriet ennå.
* `received` — levert av laboratoriet.
* `likely_wrong` — Anivas automatiske kontroll eller medlemmet tviler på genotypen. Ikke bekreftet. Se `status_reason`.
* `fault` — levert, men bekreftet feil; **må ikke brukes klinisk**. Se `status_reason`.
* `undeliverable` — laboratoriet kunne ikke produsere en genotype. Se `status_reason`.

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

Hvorfor resultatet er tvilsomt eller ubrukelig. Utfylt for `likely_wrong`, `fault` og `undeliverable`, `null` for alle andre statuser.

**lab\_code** `string`

Labkode (strekkode på prøverøret) resultatet ble registrert under. `null` for et `planned`-resultat og for resultater laboratoriet rapporterte uten kode.

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

Biomarkør-ID (gen).

**gene** `string` *required*

Gensymbol (f.eks. APOE, MTHFR).

**genotype** `string`

Visning av genotype (f.eks. E3/E4). Kan være `null`.

**clinical\_significance** `string`

Overordnet klinisk betydning. En av `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 genotypen. Kan være `null`.

**tested\_at** `string`

Datoen testen ble utført i `YYYY-MM-DD`-format. Kan være `null`.

**comment** `string`

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

**origin** `string`

Hvem som leverte dokumentet denne verdien kommer fra, tilsvarende `origin` på dokumentet. En verdi fra et opplastet dokument kommer fra at Aniva leser filen, ikke fra en laboratorierapport. `null` for et `planned`-resultat.

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

Påviste genetiske varianter.

**variantobjekt**

**name** `string` *required*

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

**clinical\_significance** `string`

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

**description** `string`

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

**hgvs\_c** `string`

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

**hgvs\_p** `string`

HGVS-proteinnotasjon. Kan være `null`.

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

Tilknyttede tilstander.

**tilstandsobjekt**

**condition** `string` *required*

Navn på tilstand/sykdom.

**association\_description** `string`

Beskrivelse av sammenhengen mellom varianten og tilstanden. Kan være `null`.

**badge** `string`

Kort merketekst for visning. Kan være `null`.

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

Enkeltnukleotidvarianter som definerer denne varianten.

**SNV-objekt**

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

dbSNP-identifikator (f.eks. rs429358).

**allele** `string` *required*

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

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

Referanseallel i populasjonen.

**hgvs\_c** `string`

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

**hgvs\_p** `string`

HGVS-proteinnotasjon. Kan være `null`.

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

Labrapportdokumenter. Bruk `GET /api/v1/documents/{id}` for å laste ned hver fil.

**dokumentobjekt**

**id** `string` *required*

Filidentifikator (UUID). Send den til [Last ned dokument](https://docs.anivahealth.com/no/api/documents/download-document.md) for å hente filen.

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

Filnavn. [Last ned dokument](https://docs.anivahealth.com/no/api/documents/download-document.md) sender det samme navnet i `Content-Disposition`. Det inneholder en dato, dokumenttittelen og labkoden, f.eks. `20260405 - Quade Befund - 7642001234.pdf`. Bruk det kun til visning. Les labkoden fra `lab_code`, ikke fra navnet.

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

Filnavn nøyaktig slik kilden leverte det, f.eks. `7642100312_B0012_FA_V.pdf` fra laboratoriet eller medlemmets eget navn ved opplasting. Aniva endrer det ikke.

**origin** `string` *required*

Hvem som leverte filen. En av `lab` (laboratoriet sendte den), `member_upload` (medlemmet lastet den opp), `staff_upload` (Aniva-ansatte lastet den opp) eller `partner_upload` (du lastet den opp med [Last opp dokument](https://docs.anivahealth.com/no/api/documents/upload-document.md)).

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

Medietypen til filen, f.eks. `application/pdf`, `image/jpeg` eller `text/csv`. De fleste labrapporter er PDF-filer.

**etag** `string`

Versjon av filinnholdet. Den endres hver gang bytene endres, så sammenlign den med verdien du har lagret for å se om du må laste ned på nytt. [Last ned dokument](https://docs.anivahealth.com/no/api/documents/download-document.md) sender den i anførselstegn som standard HTTP-headeren `ETag`. Kan være `null` når den lagrede filen mangler.

**size\_bytes** `integer`

Filstørrelse i byte. Kan være `null` når den lagrede filen mangler.

**lab\_code** `string`

Labkode (strekkode på prøverøret) som rapporten tilhører. Kan være `null` når laboratoriet ikke har oppgitt noen.

## Gjentatte kall

Aniva lagrer svaret fra dette endepunktet i 60 minutter for hver API-nøkkel. Et gjentatt kall innenfor
denne tiden får det lagrede svaret så lenge timen og resultatene er uendret. Etter en endring får du et nytt
svar. Headerne `Cache-Status` og `Age` viser at svaret er
lagret og hvor gammelt det er.

For å få beskjed om en endring med en gang, abonner på webhook-hendelsene `appointment.results.updated`, `appointment.results.completed` og `appointment.results.fault`.
Se [Gjentatte lesinger](https://docs.anivahealth.com/no/concepts/webhooks.md#gjentatte-lesinger).

## Feilresponser

| Status | Beskrivelse |
| - | - |
| `400` | Ugyldig ID-format — den oppgitte verdien er ikke en gyldig UUID. |
| `403` | Forbudt — API-nøkkelen din har ikke tilgang til denne operasjonen, eller timen er utenfor tilgangskonteksten din. |
| `404` | Time ikke funnet. |
| `500` | Intern serverfeil. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/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": "5c1e7a92-3b4d-4f8e-a6c2-9d0b1e2f3a47",
      "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": "8e4f2a61-7c3b-4d9e-b5a1-0f2e3d4c5b68",
      "status": "received",
      "status_reason": null,
      "lab_code": "7642001234",
      "biomarker_id": 93,
      "biomarker_name": "Alanine Aminotransferase (ALT)",
      "category": "Liver",
      "value": 0.33,
      "value_operator": "eq",
      "unit_id": 63,
      "unit": "µkat/L",
      "reference_range_lab": {
        "normal_min": null,
        "normal_max": 0.82,
        "optimal_min": null,
        "optimal_max": null
      },
      "reference_range_lab_absent_reason": null,
      "aniva_range": null,
      "tested_at": "2026-04-05",
      "comment": null,
      "origin": "lab",
      "lab_reported": {
        "name": "GPT (ALT) (S, U/l)",
        "code": "gpt",
        "category": "Klinische Chemie",
        "value": "20",
        "unit": "U/l",
        "reference_range": "< 50",
        "reference_range_min": null,
        "reference_range_max": 49,
        "flag": "normal",
        "result_status": "final",
        "comment": null
      }
    },
    {
      "id": "a2d9c4e7-1f6b-4a3c-8e5d-7b0c9a1f2e36",
      "status": "fault",
      "status_reason": "Sample tube contaminated with manganese — implausibly high value; the lab cancelled the request and asked for a lithium-heparin tube.",
      "lab_code": "7642001234",
      "biomarker_id": 326,
      "biomarker_name": "Manganese, whole blood mixture",
      "category": "Micronutrients",
      "value": 114,
      "value_operator": "eq",
      "unit_id": 24,
      "unit": "µg/L",
      "reference_range_lab": {
        "normal_min": 6,
        "normal_max": 11,
        "optimal_min": null,
        "optimal_max": null
      },
      "reference_range_lab_absent_reason": null,
      "aniva_range": null,
      "tested_at": "2026-04-05",
      "comment": null,
      "origin": "lab",
      "lab_reported": {
        "name": "Mangan (Vollblut, µg/l)",
        "code": "mn",
        "category": "Spurenelemente",
        "value": "114",
        "unit": "µg/l",
        "reference_range": "6 - 11",
        "reference_range_min": 6,
        "reference_range_max": 11,
        "flag": "critical_high",
        "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": "c7b3e1f9-4a2d-4e6c-9b8a-5d1f0e2c3a79",
      "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": "Appointment not found"
}
```


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