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

> Slik fungerer labresultater og dokumenter i Aniva-API-et: biomarkørverdier, referanseområder, labrapporter og webhooks for resultater.

Etter at en blodprøvetaking er bekreftet og laboratoriet har behandlet prøvene, blir resultater tilgjengelige på timen. Resultater hentes via `GET /api/v1/appointments/{id}/results` og inkluderer kliniske biomarkørresultater, genetiske biomarkørresultater og nedlastbare laboratorierapporter.

## Resultatstatus

Feltet `status` på toppnivå i resultatsvaret viser den overordnede fremdriften i behandlingen:

| Status | Betydning |
| - | - |
| `in_progress` | Noen innsendinger behandles fortsatt av laboratoriet. |
| `completed` | Alle innsendinger er avsluttet, og minst én har rapportert. |
| `fault` | Alle innsendinger feilet uten å rapportere. Ingen resultater gjenstår. |

Enkeltresultater i svaret har sin egen status per resultat (se nedenfor), slik at du kan vise delresultater mens den overordnede statusen fortsatt er `in_progress`.

Abonner på [webhooks](https://docs.anivahealth.com/no/concepts/webhooks.md) for å få beskjed når resultater endres. `appointment.results.updated` utløses ved hver endring i resultatinnholdet, og `appointment.results.completed` utløses når statusen på toppnivå går over til `completed`. Bestillinger av hjemmetestsett sender de samme hendelsene med prefikset `home_kit_order.`. Hver hendelse inneholder resultat-URL-en som skal hentes. Du kan fortsatt polle dette endepunktet for å avstemme.

Listen `submissions` deler opp statusen på toppnivå per laboratorierekvisisjon. En blodprøvetaking som omfatter flere prøverør eller flere laboratorier, har flere oppføringer, hver med den `lab_code` (strekkoden på prøverøret) den ble registrert under, og sin egen status (`in_progress` / `completed` / `fault`). En oppføring med `fault` ble avvist eller forkastet hos laboratoriet og vil aldri rapportere: prøven ble ofte flyttet til et annet laboratorium, som deretter oppretter sin egen oppføring. Statusen på toppnivå er `completed` når alle oppføringer er avsluttet og minst én har rapportert. Hvert mottatt resultat og hvert dokument har samme `lab_code`, slik at du kan se hvilket prøverør en verdi kom fra.

## Kliniske resultater

Kliniske resultater er vanlige målinger av biomarkører i blodet — som vitamin D-nivåer, kolesterol, stoffskiftehormoner og lignende.

Hvert klinisk resultat inneholder:

* **`id`** — identifikatoren for raden med laboratorieresultatet. Den forblir den samme når laboratoriet korrigerer raden, så bruk den til upsert. `null` for et `planned`-resultat.
* **`biomarker_name`** og **`category`** — hva som ble målt, og grupperingen av det (f.eks. vitaminer, hormoner).
* **`lab_code`** — laboratoriekoden (strekkoden på prøverøret) resultatet ble registrert under, en av bestillingens laboratoriekoder. `null` for et `planned`-resultat og for resultater som laboratoriet rapporterte uten kode.
* **`value`** og **`value_operator`** — den faktiske målingen. Operatoren er `eq` (er lik) for eksakte verdier, eller `lt`/`gt` når laboratoriet rapporterer en verdi under eller over det målbare området.
* **`unit`** — måleenheten (f.eks. ng/mL, µIU/mL).
* **`reference_range_lab`** — normale og optimale min-/maksgrenser slik de ble rapportert av laboratoriet for dette resultatet, konvertert til samme skala som `value`. En grense laboratoriet lar stå åpen er `null`, slik at et ensidig intervall som `< 50` kommer som `normal_min: null, normal_max: 50`. Hvert resultat har med seg intervallet det ble målt mot, slik at en pasient med resultater på tvers av flere blodprøvetakinger eller laboratorier får riktig intervall per resultat.
* **`reference_range_lab_absent_reason`** — hvorfor `reference_range_lab` er `null`. `null` når referanseområdet finnes, og på et `planned`-resultat. Se [Når det ikke finnes referanseområde fra laboratoriet](#nar-det-ikke-finnes-referanseomrade-fra-laboratoriet).
* **`aniva_range`** — 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 snevrere område. Verdiene er kun til 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.
* **`tested_at`** — datoen testen ble utført.
* **`comment`** — fritekstkommentar fra laboratoriet om dette spesifikke resultatet (f.eks. veiledning om referanseområder, advarsler om prøvekvalitet). `null` når laboratoriet ikke la ved noen.
* **`status_reason`** — hvorfor et `likely_wrong`-resultat er tvilsomt, eller hvorfor et `fault`- eller `undeliverable`-resultat er ubrukelig. `null` for alle andre statuser. Skiller seg fra `comment`, som er laboratoriets eget notat og ofte er tomt på resultater med feil.
* **`origin`** — hvem som leverte dokumentet verdien kommer fra, med de samme verdiene som dokumentets `origin` nedenfor. En verdi fra et opplastet dokument (`member_upload`, `staff_upload`, `partner_upload`) kommer fra at Aniva leser filen, ikke fra en laboratorierapport: kontroller den mot filen før klinisk bruk. `null` for et `planned`-resultat.
* **`lab_reported`** — det utførende laboratoriets egen rapportlinje, ordrett og ukonvertert. Se nedenfor.

### Aniva-områder

`aniva_range` inneholder sammenligningsverdier som Aniva har satt sammen fra publiserte kilder og
egen kuratering. Områdene varierer etter alder, kjønn og svangerskapsuke.
`sources` lister opp de publiserte kildene Aniva har registrert for verdiene. Listen kan være tom.

> [!WARNING]
>
> Verdiene er generell informasjon. De er ikke medisinske råd, ikke en diagnose, ikke et
> medisinsk funn og ikke en vurdering av et resultat. Aniva tilbyr dem ikke som medisinsk
> utstyr. Aniva sammenligner ikke et resultat med dem og setter ingen flagg mot dem.
> `reference_range_lab` og vurderingen fra en lege forblir standarden for et resultat.

Regler for produktet ditt:

* Vis Aniva-området kun i tillegg til laboratoriets område, aldri i stedet for det.
* Hvis du utleder et flagg, en advarsel eller en anbefaling fra Aniva-området, gjør du dette i
  eget navn og på eget ansvar.
* Vis merknaden fra avtalen din med Aniva overalt der du viser Aniva-området.

For å få tilgang må du signere den korte avtalen om Aniva-områder. Deretter legger vi til
scope `aniva_ranges_view` på nøkkelen din. Verdiene kan endres uten varsel.

### Normaliserte verdier kontra laboratoriets egen linje

`value`, `unit` og `reference_range_lab` er normalisert: vi konverterer hver måling til biomarkørens kanoniske enhet og rapporterer den under vårt eget biomarkørnavn, slik at den samme analytten kan sammenlignes på tvers av laboratorier og over tid. Det er dette du ønsker for trendanalyser og sammenligning på tvers av laboratorier, men det er ikke det en lege som gjennomgår svaret, ser på laboratoriets PDF — alkalisk fosfatase som står oppført som `48 U/l (40 - 129)`, kommer til deg som `0.8 µkat/L`.

`lab_reported` har med seg denne trykte linjen ved siden av: laboratoriets analyttnavn og kode, verdien og enheten slik de er trykt, referanseintervallet både som tekst (`< 50`, `> 55`, `40 - 129`) og som laboratoriets egne ukonverterte grenser, i tillegg til avviksflagg, resultatstatus og notat.

Bruk `lab_reported` når et menneske avstemmer dataene dine mot laboratoriets rapport, og de kanoniske feltene til alt som beregnes. Bare felt som laboratoriet faktisk sendte, fylles ut; ingenting i `lab_reported` utledes, får standardverdier eller konverteres, og hele objektet er `null` når vi ikke har noen rådata for et resultat.

### Når det ikke finnes referanseområde fra laboratoriet

Når `reference_range_lab` er `null`, forteller `reference_range_lab_absent_reason` deg hvorfor:

| Verdi | Betydning | Vis |
| - | - | - |
| `not_provided` | Det finnes ikke noe referanseområde. Laboratoriet sendte ikke noe. | "Ikke aktuelt" |
| `lab_text_only` | Laboratoriet oppga bare tekst, som en målverdi, et risikonivå eller et livsfaseområde. | Teksten i `lab_reported.reference_range` |
| `not_measured` | Resultatet er `undeliverable`, så det finnes ingen verdi å sammenligne. | Verdien i `status_reason` |

Noen laboratorier oppgir en målverdi eller et risikonivå i stedet for et referanseområde, for eksempel
`Ziel: <200. >240 hoch` eller `<5.7 neg >=6.5 pos`. Disse legges ikke inn i `reference_range_lab`, så
grensene er `null` og årsaken er `lab_text_only`. Vis den trykte teksten ordrett.

Et ensidig område som `< 20` er et referanseområde. Det kommer i `reference_range_lab` med én grense
satt til `null`, og årsaken er `null`. La den åpne siden forbli åpen når du viser det.

### Statuser for kliniske resultater

| Status | Betydning |
| - | - |
| `planned` | Testen er bestilt, men resultater har ikke kommet fra laboratoriet ennå. |
| `received` | Laboratoriet har returnert et resultat. |
| `corrected` | En person har revidert verdien som laboratoriet rapporterte. |
| `likely_wrong` | Anivas automatiske kontroll eller medlemmet tviler på verdien. Ikke bekreftet: ikke vis den som et funn uten gjennomgang. Se `status_reason`. |
| `fault` | Laboratoriet leverte et resultat som er bekreftet feil — **må ikke brukes klinisk**. `value` har fortsatt feil tall; se `status_reason`. |
| `undeliverable` | Laboratoriet klarte ikke å produsere en verdi. `value` er `null`; se `status_reason`. |

> [!TIP]
>
> Når du viser resultater til pasienter, bruker du feltet `value` direkte — det gjenspeiler
> allerede den korrigerte verdien når det finnes en.

> [!WARNING]
>
> Presenter aldri et `fault`-resultat som et funn — `value` er fylt ut, men bekreftet feil.

## Genetiske resultater

Genetiske resultater er funn på gennivå fra DNA-analyse. Hvert resultat tilsvarer et gen (f.eks. APOE, MTHFR) og inneholder:

* **`id`** — identifikatoren for raden med laboratorieresultatet. Den forblir den samme når laboratoriet korrigerer raden, så bruk den til upsert. `null` for et `planned`-resultat.
* **`gene`** — gensymbolet.
* **`lab_code`** — laboratoriekoden (strekkoden på prøverøret) resultatet ble registrert under. `null` for et `planned`-resultat og for resultater som laboratoriet rapporterte uten kode.
* **`genotype`** — den påviste genotypen (f.eks. E3/E4).
* **`clinical_significance`** — en ACMG-basert klassifisering av funnet.
* **`risk_description`** — en menneskelesbar forklaring på hva genotypen betyr.
* **`comment`** — fritekstkommentar fra laboratoriet om dette spesifikke resultatet. `null` når laboratoriet ikke la ved noen.
* **`status_reason`** — hvorfor et `likely_wrong`-resultat er tvilsomt, eller hvorfor et `fault`- eller `undeliverable`-resultat er ubrukelig. `null` for alle andre statuser.
* **`origin`** — hvem som leverte dokumentet verdien kommer fra, som for kliniske resultater.
* **`variants`** — de spesifikke genetiske variantene som er påvist, hver med detaljer på SNV-nivå.

### Verdier for klinisk signifikans

| Verdi | Kategori |
| - | - |
| `pathogenic`, `likely_pathogenic` | Sykdomsfremkallende eller sannsynlig sykdomsfremkallende |
| `uncertain` | Variant av usikker betydning (VUS) |
| `likely_benign`, `benign` | Ikke sykdomsfremkallende |
| `high_risk`, `moderate_risk`, `low_risk` | Klassifisering av risikonivå |
| `protective` | Beskyttende variant |
| `drug_response`, `poor_metabolizer`, `rapid_metabolizer` | Farmakogenomiske funn |

### Statuser for genetiske resultater

| Status | Betydning |
| - | - |
| `planned` | Testen er bestilt, men resultatene har ikke kommet ennå. |
| `received` | Laboratoriet har levert et resultat. |
| `likely_wrong` | Anivas automatiske kontroll eller medlemmet tviler på genotypen. Ikke bekreftet. Se `status_reason`. |
| `fault` | Laboratoriet leverte et resultat som er bekreftet feil – **skal ikke brukes klinisk**. Se `status_reason`. |
| `undeliverable` | Laboratoriet kunne ikke produsere en genotype. Se `status_reason`. |

### Variantstruktur

Hvert genetisk resultat inneholder en `variants`-liste. Hver variant inkluderer:

* **`name`** – vanlig navn (f.eks. APOE E4).
* **`clinical_significance`** – betydning på variantnivå (kan avvike fra betydningen på gennivå).
* **`conditions`** – tilknyttede sykdommer/tilstander med beskrivelser.
* **`snvs`** – de underliggende enkeltnukleotidvariantene, hver med `rs_id`, `allele`, `reference_allele` og valgfri HGVS-notasjon.

## Dokumenter

`documents`-listen i resultatresponsen inneholder referanser til nedlastbare filer med laboratorierapporter. Hvert dokument har:

* **`id`** – en fil-UUID. Send denne til `GET /api/v1/documents/{id}` for å laste ned filen.
* **`file_name`** – filnavnet, det samme som nedlastingen sender (f.eks. `20260405 - Quade Befund - 7642001234.pdf`).
* **`original_file_name`** – filnavnet nøyaktig slik laboratoriet eller opplasteren leverte det (f.eks. `7642001234_B0012_FA_E.pdf`).
* **`origin`** – hvem som leverte filen: `lab`, `member_upload`, `staff_upload` eller `partner_upload` (du lastet den opp med [Last opp dokument](https://docs.anivahealth.com/no/api/documents/upload-document.md)).
* **`content_type`** – filens medietype (f.eks. `application/pdf`). De fleste rapporter er PDF-filer. Opplastede skanninger kan være bilder eller CSV-filer.
* **`etag`** – versjonen av filinnholdet; den endres hver gang bytene endres. Lagre den og last ned på nytt bare når den endres. Det er standard HTTP entity tag, slik S3 eller Google Cloud Storage bruker den.
* **`size_bytes`** – filstørrelsen i byte.
* **`lab_code`** – labkoden (strekkoden på prøverøret) rapporten tilhører; `null` når laboratoriet ikke registrerte noen.

> [!NOTE]
>
> Tilgang til dokumenter valideres mot profilen som eier dokumentet.

## Sende resultater på e-post til kunden

Du kan gi kunden beskjed på e-post om at resultatene er klare. Kall
[Send resultater på e-post](https://docs.anivahealth.com/no/api/appointments/email-results.md) for en time, eller
[Send resultater på e-post](https://docs.anivahealth.com/no/api/home-kit-orders/email-results.md) for en bestilling av hjemmetestsett. Hvert kall sender én e-post.
Kall dedupliseres ikke.

* E-posten sendes til profilens `email`. En plassholderadresse med `@aniva.email` avvises.
* E-posten viser navnet og logoen til profilens primære profilgruppe.
* E-posten er på profilens `language`, med engelsk som standard.
* Sett `with_reports` til `true` for å legge ved labrapportene.
* Legg til `note` for å vise en personlig melding i e-posten, maksimalt 1 000 tegn.

Hvis profilen har slått av transaksjonelle e-poster, returnerer kallet `409` med årsaken
`unsubscribed`. For å slå dem på igjen setter du `transactional_emails_enabled` til `true` med
[Oppdater profil](https://docs.anivahealth.com/no/api/profiles/update-profile.md).

## E-poster når resultater er klare

Du kan få en e-post når resultatene for en bestilling er klare. Sett `results_ready_emails` til opptil 5
adresser i [Opprett time](https://docs.anivahealth.com/no/api/appointments/create-appointment.md) eller
[Opprett bestilling av hjemmetestsett](https://docs.anivahealth.com/no/api/home-kit-orders/create-home-kit.md). Endre listen senere med
[Oppdater time](https://docs.anivahealth.com/no/api/appointments/update-appointment.md) eller
[Oppdater bestilling av hjemmetestsett](https://docs.anivahealth.com/no/api/home-kit-orders/update-home-kit.md); `[]` slår av e-postene.

* Be oss sette standard e-postadresser for profilgruppen din. En bestilling som opprettes uten
  `results_ready_emails`, får disse. En liste erstatter dem for den bestillingen, så ta med
  standard e-postadresse for å beholde den. `[]` sender ingen e-post.
* Hver adresse får én e-post så snart alle laboratorieresultatene for bestillingen er endelige.
* En adresse som legges til etter at resultatene er endelige, får e-posten med en gang.
* E-posten lenker til resultatsiden i Anivas adminpanel. Kunden får den ikke.
* Nøkkelen din trenger `results_view`-tilgang til pasienten. Uten den returnerer forespørselen `403`.

## Vis resultater i appen din

[Opprett innbyggingsøkt](https://docs.anivahealth.com/no/api/profiles/create-embed-session.md) returnerer en engangs-URL til en skrivebeskyttet
resultatside. Åpne den i en WebView i appen din, så ser pasienten resultatene uten å logge inn.

* Nøkkelen din trenger scopene `embed` og `results_view` for pasienten. Be Aniva om
  `embed`-scopet.
* Kall den fra serveren din hver gang pasienten åpner resultatene. URL-en fungerer én gang og i
  5 minutter, og siden holder deretter en økt på 60 minutter.
* `route` åpner en av sidene vi tilgjengeliggjør: biomarkørlisten, én biomarkør eller 3D Twin.
* `appearance` setter temaet, fargen på knapper og lenker, og om logoen din vises.
* `report` begrenser siden til én time, én bestilling av hjemmetestsett eller én laboratorierapport som du
  lastet opp med `POST /api/v1/documents`. Pasienten ser da bare resultatene fra den rapporten.
* Siden viser bare laboratorieresultater, i likhet med dette API-et. Den viser ingen filer, ingen chat og ingen innstillinger.

## Eksempel på resultatrespons

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