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

# Hämta labbresultat

> Hämta kliniska och genetiska labbresultat för en beställning av hemtestkit

Hämta kliniska och genetiska labbresultat för en beställning av hemtestkit, tillsammans med dokumentreferenser för labbrapporter i PDF-format.

Varje biomarkör som beställts för kitet visas i svaret, så att du kan följa hela beställningen och inte bara det som kommit in. Resultat registreras under beställningens `lab_code` – laboratoriebeställningen läggs vid [aktivering](https://docs.anivahealth.com/sv/api/home-kit-orders/activate-home-kit.md), och labbet rapporterar markörer var för sig när de analyseras, så ett delsvar är normalt och `status` på toppnivå förblir `in_progress` tills slutrapporten är klar. Läs av `status` på varje resultat innan du använder dess `value`:

* Tester som ännu inte är klara visas med status `planned` medan beställningen har status `in_progress`. Du kan anropa den här slutpunkten före aktivering – då har varje beställd markör status `planned`.
* Resultat som labbet levererat men som **inte** får användas kliniskt visas med status `fault` eller `undeliverable`, och har en `status_reason` som förklarar varför. Ett resultat med status `fault` har fortfarande ett ifyllt `value` – det värdet är felaktigt. Presentera det aldrig som ett fynd.
* Resultat som Aniva eller medlemmen tvivlar på visas med status `likely_wrong` och en `status_reason`. Värdet är inte bekräftat. Visa det inte som ett fynd utan granskning.

Använd [Ladda ner dokument](https://docs.anivahealth.com/sv/api/documents/download-document.md) för att ladda ner PDF-filer med labbrapporter som refereras i arrayen `documents`.

Du behöver inte polla den här slutpunkten. Prenumerera på [webhooks](https://docs.anivahealth.com/sv/concepts/webhooks.md) för `home_kit_order.results.updated` eller `home_kit_order.results.completed`, och anropa den när en händelse kommer in. Polling fungerar fortfarande som reservlösning.

Kräver behörigheten `results_view` – labbresultat och dokument kräver alltid den, precis som resultat från bokningar och [Ladda ner dokument](https://docs.anivahealth.com/sv/api/documents/download-document.md) – samt behörigheten `home_kit_orders_view` eller `home_kit_orders_manage` för att komma åt själva kitbeställningen.

## Förfrågan

### Sökvägsparametrar

**id** `string` *required*

Unik identifierare (UUID) för den beställning av hemtestkit vars resultat ska hämtas.

## Svar

Vid framgång returnerar API:et `200 OK` med resultatobjektet.

**status** `string` *required*

Övergripande status för resultaten. Ett av följande:

* `in_progress` — vissa remisser är fortfarande hos laboratoriet.
* `completed` — varje remiss har avslutats och minst en har rapporterat.
* `fault` — varje remiss avbröts utan att rapportera. Inget återstår.

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

En post per laboratorieremiss — en blodprovstagning som omfattar flera rör eller laboratorier har
flera. `status` på toppnivå är `completed` när varje post har avslutats och en har rapporterat.

**submission-objekt**

**lab\_code** `string`

Labbkod (rörets streckkod) som den här remissen registrerades under. Kan vara `null` när laboratoriet inte registrerat
någon.

**status** `string` *required*

`in_progress` medan laboratoriet fortfarande arbetar med den, `completed` när rapporten är
slutgiltig, eller `fault` när remissen avvisades eller övergavs och aldrig kommer att rapportera —
provet flyttas ofta till ett annat laboratorium, som då registrerar sin egen post.

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

Array med kliniska biomarkörresultat.

**kliniskt resultatobjekt**

**id** `string`

Identifierare för labbresultatrad (UUID). Den förblir densamma när labbet korrigerar raden, så använd den för upsert. `null` för ett `planned`-resultat.

**status** `string` *required*

Resultatstatus. Ett av:

* `planned` — beställt, inte kommit tillbaka från labbet ännu. `value` är `null`.
* `received` — levererat av labbet.
* `corrected` — levererat och sedan ändrat av en människa. `value` är det korrigerade värdet.
* `likely_wrong` — Anivas automatiska kontroll eller medlemmen ifrågasätter värdet. Inte bekräftat: visa det inte som ett fynd utan granskning. Se `status_reason`.
* `fault` — levererat men bekräftat felaktigt; **använd inte kliniskt**. `value` innehåller den felaktiga siffran. Se `status_reason`.
* `undeliverable` — labbet kunde inte ta fram ett värde. `value` är `null`. Se `status_reason`.

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

Varför resultatet är osäkert eller oanvändbart. Ifyllt för `likely_wrong`, `fault` och `undeliverable`, `null` för alla andra statusar.

Skiljer sig från `comment`, som är labbets egen anteckning på rapporten — `comment` är tom för de flesta felaktiga resultat, så behandla `status_reason` som den gällande förklaringen.

**lab\_code** `string`

Labbkod (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.

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

Identifierare för biomarkör.

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

Visningsnamn för biomarkören.

**category** `string`

Biomarkörkategori (t.ex. Hormoner, Vitaminer). Kan vara `null`.

**value** `number`

Gällande resultatvärde (korrigerat om tillgängligt, annars råvärde). Kan vara `null`.

**value\_operator** `string`

Jämförelseoperator för värdet: `eq` (lika med), `lt` (mindre än) eller `gt` (större än). Kan vara `null`.

**unit\_id** `integer`

Identifierare för mätenhet. Kan vara `null`.

**unit** `string`

Visningsnamn för mätenhet. Kan vara `null`.

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

Referensintervall rapporterade av labbet för **detta** resultat, omvandlade till samma enhet som `value`. `null` när labbet inte rapporterade något intervall.

En gräns som labbet lämnat öppen förblir `null`, så ett ensidigt intervall fyller bara i sin egen ände — en övre gräns kommer som `normal_min: null, normal_max: 50`, en nedre som `normal_min: 55, normal_max: null`. Tolka inte en `null`-gräns som noll eller obegränsad som standard; tolka den som "labbet satte ingen gräns på den sidan".

Varje resultat innehåller det intervall det mättes mot, så en patient vars resultat spänner över flera blodprovstagningar eller flera labb får rätt intervall per resultat i stället för det senaste.

**referensintervall**

**normal\_min** `number`

Nedre gräns för normalintervall. Kan vara `null`.

**normal\_max** `number`

Övre gräns för normalintervall. Kan vara `null`.

**optimal\_min** `number`

Nedre gräns för optimalt intervall. Kan vara `null`.

**optimal\_max** `number`

Övre gräns för optimalt intervall. Kan vara `null`.

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

Varför `reference_range_lab` är `null`. `null` när `reference_range_lab` finns och för ett `planned`-resultat.

* `not_provided`: inget intervall finns. Labbet skickade inget. Visa "Ej tillämpligt".
* `lab_text_only`: labbet angav bara text, som ett målvärde, en risknivå eller ett intervall för en viss livsfas. Visa `lab_reported.reference_range`.
* `not_measured`: resultatet är `undeliverable`, så det finns inget värde att jämföra. Visa `status_reason`.

**aniva\_range** `object`

Jämförelsevärden som Aniva sammanställt, på samma skala som `value`. De skiljer sig beroende på å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 inte har några värden för denna biomarkör.

**referensintervall**

**normal\_min** `number`

Nedre gräns för normalintervall. Kan vara `null`.

**normal\_max** `number`

Övre gräns för normalintervall. Kan vara `null`.

**optimal\_min** `number`

Nedre gräns för optimalt intervall. Kan vara `null`.

**optimal\_max** `number`

Övre gräns för det snävare intervallet. Kan vara `null`.

**sources** `object[]`

Publicerade källor som Aniva registrerat för dessa värden. Varje post har en `title` och en `url`. `url` kan vara `null`. Listan är tom när Aniva inte har registrerat någon källa.

**tested\_at** `string`

Datum då testet utfördes i formatet `YYYY-MM-DD`. Kan vara `null`.

**comment** `string`

Valfri kommentar till resultatet. Kan vara `null`.

**origin** `string`

Vem som levererade dokumentet som värdet kommer från, som `origin` på dokumentet. Ett värde från ett uppladdat dokument kommer från att Aniva läst filen, inte från en labbrapport. `null` för ett `planned`-resultat.

**lab\_reported** `object`

Det utförande labbets egen rapportrad, ordagrant — för att jämföra denna payload med labbets PDF. Kan vara `null` när vi inte har någon råpost för resultatet.

Alla andra fält på ett resultat är normaliserade: `value` och `unit` konverteras till biomarkörens standardenhet, och `biomarker_name` är vårt namn på analyten, inte labbets. Fälten nedan är inte det. Behandla dem som referens enligt utskriften och de kanoniska fälten som konsekvenskontroll.

Siffrorna här är labbets egna gränser på labbets egen skala — `reference_range_min` och `reference_range_max` är **inte** enhetsomvandlade och skiljer sig från `reference_range_lab` när de två skalorna skiljer sig åt. En gräns som labbet lämnat öppen förblir `null`; inget härleds eller sätts som standard.

**rapporterat av labbet**

**name** `string`

Analytnamn som labbet skrivit ut det. Kan vara `null`.

**code** `string`

Labbets egen analytkod. Kan vara `null`.

**category** `string`

Avsnittsrubrik i rapporten, t.ex. `Klinische Chemie`. Kan vara `null`.

**value** `string`

Värde som det skrevs ut. En sträng, så att icke-numeriska resultat bevaras intakta (`<0.04`, `negativ`, `1:100`). Kan vara `null`.

**unit** `string`

Enhet som den skrevs ut, t.ex. `U/l`. Kan vara `null`.

**reference\_range** `string`

Referensintervall som det skrevs ut, inklusive ensidiga gränser: `40 - 129`, `< 50`, `> 55`. Kan vara `null`.

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

Labbets nedre gräns, ej omvandlad. `null` för ett intervall som labbet lämnat öppet nedåt.

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

Labbets övre gräns, ej omvandlad. `null` för ett intervall som labbet lämnat öppet uppåt.

**flag** `string`

Labbets avvikelseflagga för denna rad: `normal`, `high`, `low`, `critical_high`, `critical_low`, `abnormal`. En kod som vi inte känner igen skickas vidare så som labbet skickade den. Kan vara `null`.

**result\_status** `string`

Labbets resultatstatus: `final`, `preliminary`, `correction`, `incomplete`, `partial`, `deleted`, `cannot_be_obtained`. Ett `preliminary`-värde kan fortfarande ändras. En senare [webhook](https://docs.anivahealth.com/sv/concepts/webhooks.md) för `results.updated` meddelar dig när du ska hämta igen. Kan vara `null`.

**comment** `string`

Labbets egen anteckning på denna rad. Kolumnutfyllnad är komprimerad; ordalydelsen är orörd. Kan vara `null`.

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

Array med genetiska biomarkörresultat.

**genetiskt resultatobjekt**

**id** `string`

Identifierare för labbresultatrad (UUID). Den förblir densamma när labbet korrigerar raden, så använd den för upsert. `null` för ett `planned`-resultat.

**status** `string` *required*

Resultatstatus. Ett av:

* `planned` — beställt, inte kommit tillbaka från labbet ännu.
* `received` — levererat av labbet.
* `likely_wrong` — Anivas automatiska kontroll eller medlemmen ifrågasätter genotypen. Inte bekräftat. Se `status_reason`.
* `fault` — levererat men bekräftat felaktigt; **använd inte kliniskt**. Se `status_reason`.
* `undeliverable` — labbet kunde inte ta fram en genotyp. Se `status_reason`.

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

Varför resultatet är osäkert eller oanvändbart. Ifyllt för `likely_wrong`, `fault` och `undeliverable`, `null` för alla andra statusar.

**lab\_code** `string`

Labbkod (rörets streckkod) som resultatet registrerades under. `null` för ett `planned`-resultat och för resultat som labbet rapporterade utan kod.

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

Identifierare för biomarkör (gen).

**gene** `string` *required*

Gensymbol (t.ex. APOE, MTHFR).

**genotype** `string`

Visning av genotyp (t.ex. E3/E4). Kan vara `null`.

**clinical\_significance** `string`

Övergripande klinisk betydelse. Ett av `pathogenic`, `likely_pathogenic`, `uncertain`, `likely_benign`, `benign`, `high_risk`, `moderate_risk`, `low_risk`, `protective`, `drug_response`, `poor_metabolizer` eller `rapid_metabolizer`. Kan vara `null`.

**risk\_description** `string`

Riskbeskrivning för denna genotyp. Kan vara `null`.

**tested\_at** `string`

Datum då testet utfördes i formatet `YYYY-MM-DD`. Kan vara `null`.

**comment** `string`

Valfri kommentar till resultatet. Kan vara `null`.

**origin** `string`

Vem som levererade dokumentet som värdet kommer från, som `origin` på dokumentet. Ett värde från ett uppladdat dokument kommer från att Aniva läst filen, inte från en labbrapport. `null` för ett `planned`-resultat.

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

Upptäckta genetiska varianter.

**variantobjekt**

**name** `string` *required*

Variantens vanliga namn (t.ex. APOE E4).

**clinical\_significance** `string`

Klinisk betydelse på variantnivå. Kan vara `null`.

**description** `string`

Beskrivning av varianten. Kan vara `null`.

**hgvs\_c** `string`

HGVS-notation för kodande DNA. Kan vara `null`.

**hgvs\_p** `string`

HGVS-notation för protein. Kan vara `null`.

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

Associerade tillstånd.

**tillståndsobjekt**

**condition** `string` *required*

Namn på tillstånd/sjukdom.

**association\_description** `string`

Beskrivning av sambandet mellan varianten och tillståndet. Kan vara `null`.

**badge** `string`

Kort etikett för visning. Kan vara `null`.

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

Enkelnukleotidvarianter som definierar denna variant.

**SNV-objekt**

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

dbSNP-identifierare (t.ex. rs429358).

**allele** `string` *required*

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

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

Referensallel i populationen.

**hgvs\_c** `string`

HGVS-notation för kodande DNA. Kan vara `null`.

**hgvs\_p** `string`

HGVS-notation för protein. Kan vara `null`.

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

Dokument med labbrapporter. Använd `GET /api/v1/documents/{id}` för att ladda ner varje fil.

**dokumentobjekt**

**id** `string` *required*

Filidentifierare (UUID). Skicka med detta till [Ladda ner dokument](https://docs.anivahealth.com/sv/api/documents/download-document.md) för att hämta filen.

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

Filnamn. [Ladda ner dokument](https://docs.anivahealth.com/sv/api/documents/download-document.md) skickar samma namn i `Content-Disposition`. Det innehåller ett datum, dokumentets titel och labbkoden, t.ex. `20260405 - Quade Befund - 7642001234.pdf`. Använd det bara för visning. Läs labbkoden från `lab_code`, inte från namnet.

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

Filnamnet exakt som källan levererade det, t.ex. `7642100312_B0012_FA_V.pdf` från laboratoriet eller medlemmens eget namn vid en uppladdning. Aniva ändrar det inte.

**origin** `string` *required*

Vem som levererade filen. Ett av `lab` (laboratoriet skickade den), `member_upload` (medlemmen laddade upp den), `staff_upload` (Anivas personal laddade upp den) eller `partner_upload` (du laddade upp den med [Ladda upp dokument](https://docs.anivahealth.com/sv/api/documents/upload-document.md)).

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

Filens medietyp, t.ex. `application/pdf`, `image/jpeg` eller `text/csv`. De flesta labbrapporter är PDF-filer.

**etag** `string`

Version av filinnehållet. Den ändras så snart filens byte ändras, så jämför den med värdet du har sparat för att se om du behöver ladda ner filen igen. [Ladda ner dokument](https://docs.anivahealth.com/sv/api/documents/download-document.md) skickar den inom citattecken som standardheadern `ETag` i HTTP. Kan vara `null` när den sparade filen saknas.

**size\_bytes** `integer`

Filstorlek i byte. Kan vara `null` när den sparade filen saknas.

**lab\_code** `string`

Labbkod (streckkod på provröret) som rapporten tillhör. Kan vara `null` när laboratoriet inte har angett någon.

## Upprepade anrop

Aniva sparar svaret från den här slutpunkten i 60 minuter per API-nyckel. Ett upprepat anrop inom
den tiden får det sparade svaret så länge beställningen av hemtestkit och dess resultat är oförändrade. Efter en ändring får du ett nytt
svar. Huvudena `Cache-Status` och `Age` visar att svaret är
sparat och hur gammalt det är.

För att få reda på en ändring direkt kan du prenumerera på webhook-händelserna `home_kit_order.results.updated`, `home_kit_order.results.completed` och `home_kit_order.results.fault`.
Se [Upprepade läsningar](https://docs.anivahealth.com/sv/concepts/webhooks.md#upprepade-laesningar).

## Felsvar

| Status | Beskrivning |
| - | - |
| `400` | Ogiltigt ID-format – det angivna värdet är inte en giltig UUID. |
| `403` | Förbjudet – din API-nyckel saknar behörigheten `results_view`, saknar både `home_kit_orders_view` och `home_kit_orders_manage`, eller så ligger beställningen av hemtestkit utanför din åtkomstkontext. |
| `404` | Beställningen av hemtestkit hittades inte. |
| `500` | Internt serverfel. |

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