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

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

Varje biomarkör som beställts för bokningen visas i svaret, så att du kan följa hela beställningen i stället för bara det som kommit tillbaka. Läs `status` på varje resultat innan du använder dess `value`:

* Tester som ännu inte är klara visas med statusen `planned` medan bokningen har statusen `in_progress`.
* Resultat som laboratoriet levererat men som **inte** får användas kliniskt visas med statusen `fault` eller `undeliverable` och har en `status_reason` som förklarar varför. Ett resultat med `fault` har fortfarande sitt `value` ifyllt — det värdet är fel. Presentera det aldrig som ett fynd.
* Resultat som Aniva eller medlemmen tvivlar på visas med statusen `likely_wrong` och en `status_reason`. Värdet är inte bekräftat. Visa det inte som ett fynd utan granskning.

Varje mottaget resultat och dokument har den `lab_code` (rörets streckkod) som det registrerats under, och arrayen `submissions` listar varje laboratorieremiss från blodprovstagningen med egen status — en blodprovstagning som omfattar flera rör eller laboratorier slutförs remiss för remiss.

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 endpointen. Prenumerera på [webhooks](https://docs.anivahealth.com/sv/concepts/webhooks.md) för `appointment.results.updated` eller `appointment.results.completed` och anropa den när en händelse kommer in. Polling fungerar fortfarande som reservlösning.

Kräver scopet `results_view`.

## Förfrågan

### Sökvägsparametrar

**id** `string` *required*

Unik identifierare (UUID) för bokningen som resultat ska hämtas för.

## 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 lagrar svaret från den här slutpunkten i 60 minuter per API-nyckel. Ett upprepat anrop inom
den tiden får det lagrade svaret så länge bokningen och dess resultat är oförändrade. Efter en ändring får du ett nytt
svar. Headerna `Cache-Status` och `Age` visar att svaret är
lagrat och hur gammalt det är.

För att få veta om en ändring direkt, prenumerera på webhook-händelserna `appointment.results.updated`, `appointment.results.completed` och `appointment.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 ett giltigt UUID. |
| `403` | Åtkomst nekad – din API-nyckel har inte behörighet till den här åtgärden eller så ligger bokningen utanför din åtkomstkontext. |
| `404` | Bokningen hittades inte. |
| `500` | Internt serverfel. |

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