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

# Resultat

> Så fungerar labbresultat och dokument i Aniva API: biomarkörvärden, referensintervall, labbrapporter och webhooks för resultat.

När en blodprovstagning har bekräftats och labbet har behandlat proverna blir resultaten tillgängliga på bokningen. Resultaten hämtas via `GET /api/v1/appointments/{id}/results` och innehåller kliniska biomarkörresultat, genetiska biomarkörresultat och nedladdningsbara labbrapporter.

## Resultatstatus

Fältet `status` på toppnivå i resultatsvaret visar hur långt behandlingen har kommit:

| Status | Betydelse |
| - | - |
| `in_progress` | Vissa remisser behandlas fortfarande av labbet. |
| `completed` | Alla remisser är avslutade och minst en har rapporterat. |
| `fault` | Alla remisser misslyckades utan att rapportera. Inga fler resultat återstår. |

Enskilda resultat i svaret har sin egen status per resultat (se nedan), så du kan visa delresultat medan den övergripande statusen fortfarande är `in_progress`.

Prenumerera på [webhooks](https://docs.anivahealth.com/sv/concepts/webhooks.md) för att få veta när resultat ändras. `appointment.results.updated` utlöses vid varje ändring av resultatinnehållet, och `appointment.results.completed` utlöses när statusen på toppnivå ändras till `completed`. Beställningar av hemtestkit skickar samma händelser med prefixet `home_kit_order.`. Varje händelse innehåller resultat-URL:en som ska hämtas. Du kan fortfarande polla den här slutpunkten för att stämma av.

Arrayen `submissions` delar upp statusen på toppnivå per laboratorieremiss. En blodprovstagning som omfattar flera rör eller flera laboratorier har flera poster, var och en med den `lab_code` (rörets streckkod) den registrerades under och en egen status (`in_progress` / `completed` / `fault`). En post med `fault` avvisades eller avbröts på labbet och kommer aldrig att rapportera: provet flyttades ofta till ett annat laboratorium, som då registrerar en egen post. Statusen på toppnivå är `completed` när alla poster har avslutats och minst en har rapporterat. Varje mottaget resultat och varje dokument har samma `lab_code`, så du kan se vilket rör ett värde kommer ifrån.

## Kliniska resultat

Kliniska resultat är vanliga mätningar av biomarkörer i blodet — till exempel D-vitaminnivåer, kolesterol, sköldkörtelhormoner och liknande.

Varje kliniskt resultat innehåller:

* **`id`** — identifieraren för labbresultatraden. Den förblir densamma när labbet korrigerar raden, så använd den för upsert. `null` för ett `planned`-resultat.
* **`biomarker_name`** och **`category`** — vad som mättes och dess gruppering (t.ex. vitaminer, hormoner).
* **`lab_code`** — labbkoden (rörets streckkod) som resultatet registrerades under, en av beställningens labbkoder. `null` för ett `planned`-resultat och för resultat som labbet rapporterade utan kod.
* **`value`** och **`value_operator`** — det faktiska mätvärdet. Operatorn är `eq` (lika med) för exakta värden, eller `lt`/`gt` när labbet rapporterar ett värde under eller över det mätbara intervallet.
* **`unit`** — måttenheten (t.ex. ng/mL, µIU/mL).
* **`reference_range_lab`** — normala och optimala min-/maxgränser som labbet rapporterat för det här resultatet, omvandlade till samma skala som `value`. En gräns som labbet lämnar öppen är `null`, så ett ensidigt intervall som `< 50` kommer som `normal_min: null, normal_max: 50`. Varje resultat innehåller det intervall som det mättes mot, så en patient med resultat från flera blodprovstagningar eller labb får rätt intervall per resultat.
* **`reference_range_lab_absent_reason`** — varför `reference_range_lab` är `null`. `null` när intervallet finns och på ett `planned`-resultat. Se [När det saknas labbintervall](#naer-det-saknas-labbintervall).
* **`aniva_range`** — Jämförelsevärden som Aniva har sammanställt, på samma skala som `value`. De varierar efter ålder, kön och graviditetsvecka. `normal_*` är det allmänna intervallet. `optimal_*` är ett snävare intervall. Värdena är endast information. De är inte medicinsk rådgivning, inte en diagnos och inte en bedömning av resultatet. Aniva sätter ingen flagga mot dem. Använd `reference_range_lab` som standard för resultatet. `null` när din nyckel inte har scopet `aniva_ranges_view`, eller när Aniva saknar värden för den här biomarkören.
* **`tested_at`** — datumet då testet utfördes.
* **`comment`** — fritextanteckning från labbet för just det här resultatet (t.ex. vägledning om referensintervall, varningar om provkvalitet). `null` när labbet inte bifogat någon.
* **`status_reason`** — varför ett `likely_wrong`-resultat är tveksamt, eller varför ett `fault`- eller `undeliverable`-resultat är oanvändbart. `null` för alla andra statusar. Skiljer sig från `comment`, som är labbets egen anteckning och ofta är tom på felaktiga resultat.
* **`origin`** — vem som levererade dokumentet värdet kommer från, med samma värden som dokumentets `origin` nedan. Ett värde från ett uppladdat dokument (`member_upload`, `staff_upload`, `partner_upload`) kommer från att Aniva läst av filen, inte från en labbrapport: kontrollera det mot filen före klinisk användning. `null` för ett `planned`-resultat.
* **`lab_reported`** — det utförande labbets egen rapportrad, ordagrant och utan omvandling. Se nedan.

### Aniva-intervall

`aniva_range` innehåller jämförelsevärden som Aniva har sammanställt från publicerade källor och
eget urval. Intervallen varierar efter ålder, kön och graviditetsvecka.
`sources` listar de publicerade källor som Aniva har registrerat för värdena. Listan kan vara tom.

> [!WARNING]
>
> Värdena är allmän information. De är inte medicinsk rådgivning, inte en diagnos, inte ett
> medicinskt fynd och inte en bedömning av ett resultat. Aniva tillhandahåller dem inte som en
> medicinteknisk produkt. Aniva jämför inte ett resultat med dem och sätter ingen flagga mot dem.
> `reference_range_lab` och bedömningen av en läkare förblir standard för ett resultat.

Regler för din produkt:

* Visa bara Aniva-intervallet som ett tillägg till laboratoriets intervall, aldrig i stället för det.
* Om du härleder en flagga, en varning eller en rekommendation från Aniva-intervallet gör du det i
  eget namn och på eget ansvar.
* Visa upplysningen från ditt avtal med Aniva överallt där du visar Aniva-intervallet.

För att få åtkomst signerar du det korta avtalet om Aniva-intervall. Därefter lägger vi till
scopet `aniva_ranges_view` på din nyckel. Värdena kan ändras utan förvarning.

### Normaliserade värden jämfört med labbets egen rad

`value`, `unit` och `reference_range_lab` är normaliserade: vi omvandlar varje mätning till biomarkörens standardenhet och rapporterar den under vårt eget biomarkörnamn, så att samma analyt går att jämföra mellan labb och över tid. Det är vad du vill ha för trender och jämförelser mellan labb, och det är inte vad en granskande läkare ser på labbets PDF — alkaliskt fosfatas som står som `48 U/l (40 - 129)` når dig som `0.8 µkat/L`.

`lab_reported` innehåller den utskrivna raden vid sidan av: labbets analytnamn och kod, värdet och enheten som de skrevs ut, referensintervallet både som text (`< 50`, `> 55`, `40 - 129`) och som labbets egna oomvandlade gränser, plus dess avvikelseflagga, resultatstatus och anteckning.

Använd `lab_reported` när en människa stämmer av dina data mot labbets rapport, och standardfälten för allt som beräknas. Endast fält som labbet faktiskt skickade fylls i; inget i `lab_reported` härleds, ges standardvärden eller omvandlas, och hela objektet är `null` när vi saknar rådata för ett resultat.

### När det saknas labbintervall

När `reference_range_lab` är `null` visar `reference_range_lab_absent_reason` varför:

| Värde | Betydelse | Visa |
| - | - | - |
| `not_provided` | Det finns inget intervall. Labbet skickade inget. | "Ej tillämpligt" |
| `lab_text_only` | Labbet angav bara text, som ett målvärde, en risknivå eller ett intervall per livsfas. | Texten i `lab_reported.reference_range` |
| `not_measured` | Resultatet är `undeliverable`, så det finns inget värde att jämföra. | `status_reason` |

Vissa labb anger ett målvärde eller en risknivå i stället för ett referensintervall, till exempel
`Ziel: <200. >240 hoch` eller `<5.7 neg >=6.5 pos`. Dessa hamnar inte i `reference_range_lab`, så dess
gränser är `null` och orsaken är `lab_text_only`. Visa den angivna texten ordagrant.

Ett ensidigt intervall som `< 20` är ett intervall. Det kommer i `reference_range_lab` med ena gränsen
som `null`, och orsaken är `null`. Behåll den öppna sidan öppen när du visar det.

### Statusar för kliniska resultat

| Status | Betydelse |
| - | - |
| `planned` | Testet är beställt men resultat har ännu inte kommit från labbet. |
| `received` | Labbet har lämnat ett resultat. |
| `corrected` | En mänsklig granskare har reviderat det värde labbet rapporterade. |
| `likely_wrong` | Anivas automatiska kontroll eller medlemmen tvivlar på värdet. Inte bekräftat: visa det inte som ett fynd utan granskning. Se `status_reason`. |
| `fault` | Labbet levererade ett resultat som bekräftats felaktigt — **använd inte kliniskt**. `value` innehåller fortfarande fel siffra; se `status_reason`. |
| `undeliverable` | Labbet kunde inte ta fram ett värde. `value` är `null`; se `status_reason`. |

> [!TIP]
>
> När du visar resultat för patienter använder du fältet `value` direkt — det visar redan det
> korrigerade värdet om det finns ett.

> [!WARNING]
>
> Visa aldrig ett `fault`-resultat som ett fynd — dess `value` är ifyllt men bekräftat felaktigt.

## Genetiska resultat

Genetiska resultat är fynd på gennivå från DNA-analys. Varje resultat motsvarar en gen (t.ex. APOE, MTHFR) och innehåller:

* **`id`** — identifieraren för labbresultatraden. Den förblir densamma när labbet korrigerar raden, så använd den för upsert. `null` för ett `planned`-resultat.
* **`gene`** — gensymbolen.
* **`lab_code`** — labbkoden (rörets streckkod) som resultatet registrerades under. `null` för ett `planned`-resultat och för resultat som labbet rapporterade utan kod.
* **`genotype`** — den upptäckta genotypen (t.ex. E3/E4).
* **`clinical_significance`** — en ACMG-baserad klassificering av fyndet.
* **`risk_description`** — en läsbar förklaring av vad genotypen innebär.
* **`comment`** — fritextanteckning från labbet för just det här resultatet. `null` när labbet inte bifogat någon.
* **`status_reason`** — varför ett `likely_wrong`-resultat är tveksamt, eller varför ett `fault`- eller `undeliverable`-resultat är oanvändbart. `null` för alla andra statusar.
* **`origin`** — vem som levererade dokumentet värdet kommer från, på samma sätt som för kliniska resultat.
* **`variants`** — de specifika genetiska varianter som upptäckts, var och en med detaljer på SNV-nivå.

### Värden för klinisk signifikans

| Värde | Kategori |
| - | - |
| `pathogenic`, `likely_pathogenic` | Sjukdomsorsakande eller sannolikt sjukdomsorsakande |
| `uncertain` | Variant av oklar betydelse (VUS) |
| `likely_benign`, `benign` | Inte sjukdomsorsakande |
| `high_risk`, `moderate_risk`, `low_risk` | Risknivåklassificering |
| `protective` | Skyddande variant |
| `drug_response`, `poor_metabolizer`, `rapid_metabolizer` | Farmakogenomiska fynd |

### Statusar för genetiska resultat

| Status | Betydelse |
| - | - |
| `planned` | Testet är beställt men resultaten har inte kommit än. |
| `received` | Laboratoriet har returnerat ett resultat. |
| `likely_wrong` | Anivas automatiska kontroll eller medlemmen tvivlar på genotypen. Inte bekräftat. Se `status_reason`. |
| `fault` | Laboratoriet levererade ett resultat som bekräftats vara felaktigt — **använd inte kliniskt**. Se `status_reason`. |
| `undeliverable` | Laboratoriet kunde inte ta fram en genotyp. Se `status_reason`. |

### Variantstruktur

Varje genetiskt resultat innehåller en `variants`-array. Varje variant inkluderar:

* **`name`** — vanligt namn (t.ex. APOE E4).
* **`clinical_significance`** — betydelse på variantnivå (kan skilja sig från betydelsen på gennivå).
* **`conditions`** — associerade sjukdomar/tillstånd med beskrivningar.
* **`snvs`** — de underliggande enkelnukleotidvarianterna, var och en med `rs_id`, `allele`, `reference_allele` och valfri HGVS-notation.

## Dokument

Arrayen `documents` i resultatsvaret innehåller referenser till nedladdningsbara filer med labbrapporter. Varje dokument har:

* **`id`** — filens UUID. Skicka detta till `GET /api/v1/documents/{id}` för att ladda ner filen.
* **`file_name`** — filnamnet, samma som skickas vid nedladdning (t.ex. `20260405 - Quade Befund - 7642001234.pdf`).
* **`original_file_name`** — filnamnet exakt som laboratoriet eller uppladdaren levererade det (t.ex. `7642001234_B0012_FA_E.pdf`).
* **`origin`** — vem som levererade filen: `lab`, `member_upload`, `staff_upload` eller `partner_upload` (du laddade upp den med [Ladda upp dokument](https://docs.anivahealth.com/sv/api/documents/upload-document.md)).
* **`content_type`** — filens mediatyp (t.ex. `application/pdf`). De flesta rapporter är PDF-filer. Uppladdade skanningar kan vara bilder eller CSV-filer.
* **`etag`** — versionen av filinnehållet; den ändras varje gång filens byte ändras. Spara den och ladda bara ner igen när den ändras. Det är den vanliga HTTP-entitetstaggen, som används av S3 eller Google Cloud Storage.
* **`size_bytes`** — filstorleken i byte.
* **`lab_code`** — labbkoden (provrörets streckkod) som rapporten tillhör; `null` när laboratoriet inte angett någon.

> [!NOTE]
>
> Åtkomst till dokument valideras mot den profil som äger dokumentet.

## Mejla resultat till kunden

Du kan meddela kunden via mejl att resultaten är klara. Anropa
[Mejla resultat](https://docs.anivahealth.com/sv/api/appointments/email-results.md) för en bokning, eller
[Mejla resultat](https://docs.anivahealth.com/sv/api/home-kit-orders/email-results.md) för en beställning av hemtestkit. Varje anrop skickar ett mejl.
Anrop dedupliceras inte.

* Mejlet skickas till profilens `email`. En platshållaradress med `@aniva.email` avvisas.
* Mejlet visar namnet och logotypen för profilens primära profilgrupp.
* Mejlet är på profilens `language`, engelska som standard.
* Sätt `with_reports` till `true` för att bifoga labbrapporterna.
* Lägg till `note` för att visa ett personligt meddelande i mejlet, högst 1 000 tecken.

Om profilen har stängt av transaktionsmejl returnerar anropet `409` med orsaken
`unsubscribed`. För att slå på dem igen, sätt `transactional_emails_enabled` till `true` med
[Uppdatera profil](https://docs.anivahealth.com/sv/api/profiles/update-profile.md).

## Mejl när resultat är klara

Du kan få ett mejl när resultaten för en bokning är klara. Sätt `results_ready_emails` till upp till 5
adresser i [Skapa bokning](https://docs.anivahealth.com/sv/api/appointments/create-appointment.md) eller
[Skapa beställning av hemtestkit](https://docs.anivahealth.com/sv/api/home-kit-orders/create-home-kit.md). Ändra listan senare med
[Uppdatera bokning](https://docs.anivahealth.com/sv/api/appointments/update-appointment.md) eller
[Uppdatera beställning av hemtestkit](https://docs.anivahealth.com/sv/api/home-kit-orders/update-home-kit.md); `[]` stänger av mejlen.

* Be oss ställa in standardmejladresser för din profilgrupp. En bokning som skapas utan
  `results_ready_emails` får dem. En lista ersätter dem för den bokningen, så inkludera din
  standardmejladress för att behålla den. `[]` skickar inget mejl.
* Varje adress får ett mejl så snart alla labbresultat för bokningen är slutgiltiga.
* En adress som läggs till efter att resultaten är slutgiltiga får mejlet direkt.
* Mejlet länkar till resultatsidan i Anivas adminpanel. Kunden får inte mejlet.
* Din nyckel behöver `results_view`-åtkomst till patienten. Utan den returnerar förfrågan `403`.

## Visa resultat i din app

[Skapa inbäddningssession](https://docs.anivahealth.com/sv/api/profiles/create-embed-session.md) returnerar en engångs-URL till en skrivskyddad
resultatsida. Öppna den i en WebView i din app så att patienten ser resultaten utan att logga in.

* Din nyckel behöver `embed`- och `results_view`-scopes för patienten. Be Aniva om
  `embed`-scopet.
* Anropa den från din server varje gång patienten öppnar resultaten. URL:en fungerar en gång och i
  5 minuter, och sidan håller sedan en 60-minuterssession.
* `route` öppnar en av sidorna vi släpper: biomarkörlistan, en biomarkör eller 3D Twin.
* `appearance` styr temat, färgen på knappar och länkar samt om din logotyp visas.
* `report` begränsar sidan till en bokning, en beställning av hemtestkit eller en labbrapport som du
  laddat upp med `POST /api/v1/documents`. Patienten ser då bara resultaten från den rapporten.
* Sidan visar bara labbresultat, precis som det här API:et. Den visar inga filer, ingen chatt och inga inställningar.

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