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

# Labresultaten ophalen

> Klinische en genetische labresultaten ophalen voor een thuistestkit-bestelling

Haal klinische en genetische labresultaten op voor een thuistestkitbestelling, samen met documentverwijzingen voor pdf's van labrapporten.

Elke biomarker die voor de kit is besteld verschijnt in het antwoord, zodat je de hele bestelling kunt volgen in plaats van alleen wat al binnen is. Resultaten worden geregistreerd onder de `lab_code` van de bestelling — de laboratoriumbestelling wordt geplaatst bij [activering](https://docs.anivahealth.com/nl/api/home-kit-orders/activate-home-kit.md), en het lab rapporteert markers afzonderlijk zodra ze zijn geanalyseerd, dus een gedeeltelijke payload is normaal en de `status` op het hoogste niveau blijft `in_progress` tot het eindrapport. Lees `status` van elk resultaat voordat je de `value` gebruikt:

* Tests die nog openstaan verschijnen met status `planned` zolang de bestelling `in_progress` is. Je kunt dit endpoint vóór activering aanroepen — elke bestelde marker heeft dan de status `planned`.
* Resultaten die het lab heeft geleverd maar die klinisch **niet** gebruikt mogen worden, verschijnen met status `fault` of `undeliverable` en bevatten een `status_reason` die uitlegt waarom. Een `fault`-resultaat heeft nog steeds een ingevulde `value` — die waarde is onjuist. Presenteer deze nooit als een bevinding.
* Resultaten waar Aniva of het lid aan twijfelt, verschijnen met status `likely_wrong` en een `status_reason`. De waarde is niet bevestigd. Toon deze niet als een bevinding zonder beoordeling.

Gebruik [Document downloaden](https://docs.anivahealth.com/nl/api/documents/download-document.md) om pdf's van labrapporten te downloaden waarnaar de array `documents` verwijst.

Je hoeft dit endpoint niet te pollen. Abonneer je op de [webhooks](https://docs.anivahealth.com/nl/concepts/webhooks.md) `home_kit_order.results.updated` of `home_kit_order.results.completed`, en roep het endpoint aan zodra er een event binnenkomt. Polling werkt nog steeds als terugvaloptie.

Vereist de scope `results_view` — labresultaten en documenten zijn hier altijd door afgeschermd, net als resultaten van afspraken en [Document downloaden](https://docs.anivahealth.com/nl/api/documents/download-document.md) — plus de scope `home_kit_orders_view` of `home_kit_orders_manage` voor toegang tot de kitbestelling zelf.

## Verzoek

### Padparameters

**id** `string` *required*

Unieke identifier (UUID) van de thuistestkitbestelling waarvoor je resultaten wilt ophalen.

## Respons

Bij succes retourneert de API `200 OK` met het resultatenobject.

**status** `string` *required*

Algemene status van de resultaten. Een van:

* `in_progress` — sommige aanvragen liggen nog bij het laboratorium.
* `completed` — elke aanvraag is afgesloten en minstens één heeft gerapporteerd.
* `fault` — elke aanvraag is mislukt zonder te rapporteren. Er staat niets meer open.

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

Eén item per laboratoriumaanvraag — een bloedafname verspreid over meerdere buisjes of laboratoria heeft er
meerdere. De `status` op het hoogste niveau is `completed` zodra elk item is afgesloten en er één heeft gerapporteerd.

**submission-object**

**lab\_code** `string`

Labcode (barcode van het buisje) waaronder deze aanvraag is ingediend. Kan `null` zijn als het lab er geen
heeft ingediend.

**status** `string` *required*

`in_progress` zolang het laboratorium er nog aan werkt, `completed` zodra het rapport
definitief is, of `fault` als de aanvraag is afgewezen of gestaakt en nooit zal rapporteren — het
monster wordt vaak verplaatst naar een ander laboratorium, dat vervolgens een eigen item indient.

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

Array van klinische biomarkerresultaten.

**klinisch resultaatobject**

**id** `string`

ID van de labresultaatrij (UUID). Dit blijft gelijk wanneer het lab die rij corrigeert, dus gebruik dit om te upserten. `null` voor een `planned`-resultaat.

**status** `string` *required*

Status van het resultaat. Een van:

* `planned` — besteld, nog niet door het lab geleverd. `value` is `null`.
* `received` — geleverd door het lab.
* `corrected` — geleverd en daarna door een mens herzien. `value` is de gecorrigeerde waarde.
* `likely_wrong` — de automatische controle van Aniva of het lid twijfelt aan de waarde. Niet bevestigd: toon deze niet als bevinding zonder beoordeling. Zie `status_reason`.
* `fault` — geleverd maar bevestigd onjuist; **niet klinisch gebruiken**. `value` bevat de onjuiste waarde. Zie `status_reason`.
* `undeliverable` — het lab kon geen waarde bepalen. `value` is `null`. Zie `status_reason`.

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

Waarom het resultaat twijfelachtig of onbruikbaar is. Gevuld voor `likely_wrong`, `fault` en `undeliverable`, `null` voor elke andere status.

Anders dan `comment`, wat de eigen opmerking van het lab op het rapport is — `comment` is leeg bij de meeste foutieve resultaten, dus beschouw `status_reason` als de leidende uitleg.

**lab\_code** `string`

Labcode (barcode van het buisje) waaronder het resultaat is vastgelegd — een van de labcodes van de bestelling. `null` voor een `planned`-resultaat en voor resultaten die het lab zonder code heeft gerapporteerd.

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

Biomarker-ID.

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

Weergavenaam van de biomarker.

**category** `string`

Categorie van de biomarker (bijv. Hormonen, Vitamines). Kan `null` zijn.

**value** `number`

Effectieve resultaatwaarde (gecorrigeerd indien beschikbaar, anders onbewerkt). Kan `null` zijn.

**value\_operator** `string`

Vergelijkingsoperator voor de waarde: `eq` (gelijk aan), `lt` (kleiner dan) of `gt` (groter dan). Kan `null` zijn.

**unit\_id** `integer`

ID van de meeteenheid. Kan `null` zijn.

**unit** `string`

Weergavenaam van de meeteenheid. Kan `null` zijn.

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

Referentiebereiken die het lab voor **dit** resultaat heeft gerapporteerd, omgerekend naar dezelfde eenheid als `value`. `null` wanneer het lab geen bereik heeft gerapporteerd.

Een grens die het lab heeft opengelaten blijft `null`, dus bij een eenzijdig interval is alleen dat uiteinde gevuld — een bovengrens komt binnen als `normal_min: null, normal_max: 50`, een ondergrens als `normal_min: 55, normal_max: null`. Lees een `null`-grens niet als nul of standaard onbegrensd; lees deze als "het lab heeft aan die kant geen limiet gesteld".

Elk resultaat bevat het bereik waartegen het is gemeten, zodat een patiënt met resultaten van meerdere bloedafnames of meerdere labs per resultaat het juiste interval krijgt in plaats van het meest recente.

**referentiebereik**

**normal\_min** `number`

Ondergrens van het normale bereik. Kan `null` zijn.

**normal\_max** `number`

Bovengrens van het normale bereik. Kan `null` zijn.

**optimal\_min** `number`

Ondergrens van het optimale bereik. Kan `null` zijn.

**optimal\_max** `number`

Bovengrens van het optimale bereik. Kan `null` zijn.

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

Waarom `reference_range_lab` `null` is. `null` wanneer `reference_range_lab` aanwezig is, en bij een `planned`-resultaat.

* `not_provided`: er bestaat geen bereik. Het lab heeft er geen meegestuurd. Toon "Niet van toepassing".
* `lab_text_only`: het lab heeft alleen tekst afgedrukt, zoals een streefwaarde, een risicocategorie of een bereik per levensfase. Toon `lab_reported.reference_range`.
* `not_measured`: het resultaat is `undeliverable`, dus er is geen waarde om te vergelijken. Toon `status_reason`.

**aniva\_range** `object`

Vergelijkingswaarden die Aniva heeft samengesteld, op dezelfde schaal als `value`. Ze verschillen per leeftijd, geslacht en zwangerschapsweek. `normal_*` is het algemene bereik. `optimal_*` is een smaller bereik. De waarden zijn alleen ter informatie. Ze zijn geen medisch advies, geen diagnose en geen beoordeling van het resultaat. Aniva plaatst op basis hiervan geen markering. Gebruik `reference_range_lab` als de standaard voor het resultaat. `null` wanneer je sleutel de scope `aniva_ranges_view` niet heeft, of wanneer Aniva geen waarden voor deze biomarker heeft.

**referentiebereik**

**normal\_min** `number`

Ondergrens van het normale bereik. Kan `null` zijn.

**normal\_max** `number`

Bovengrens van het normale bereik. Kan `null` zijn.

**optimal\_min** `number`

Ondergrens van het optimale bereik. Kan `null` zijn.

**optimal\_max** `number`

Bovengrens van het smallere bereik. Kan `null` zijn.

**sources** `object[]`

Gepubliceerde bronnen die Aniva voor deze waarden heeft vastgelegd. Elk item heeft een `title` en een `url`. De `url` kan `null` zijn. De lijst is leeg wanneer Aniva geen bron heeft vastgelegd.

**tested\_at** `string`

Datum waarop de test is uitgevoerd in `YYYY-MM-DD`-formaat. Kan `null` zijn.

**comment** `string`

Optionele opmerking bij het resultaat. Kan `null` zijn.

**origin** `string`

Wie het document heeft aangeleverd waaruit deze waarde komt, net als `origin` op het document. Een waarde uit een geüpload document is door Aniva uit het bestand gelezen, niet afkomstig uit een labrapport. `null` voor een `planned`-resultaat.

**lab\_reported** `object`

De eigen rapportregel van het uitvoerende lab, letterlijk overgenomen — om deze payload te vergelijken met de PDF van het lab. Kan `null` zijn wanneer we geen onbewerkt record voor het resultaat hebben.

Elk ander veld op een resultaat is genormaliseerd: `value` en `unit` worden omgerekend naar de standaardeenheid van de biomarker en `biomarker_name` is onze naam voor de analyt, niet die van het lab. De velden hieronder zijn dat niet. Gebruik ze als referentie voor hoe het is afgedrukt en de canonieke velden als consistentiecontrole.

De getallen hier zijn de eigen grenzen van het lab op de eigen schaal van het lab — `reference_range_min` en `reference_range_max` worden **niet** naar een andere eenheid omgerekend en wijken af van `reference_range_lab` zodra de twee schalen verschillen. Een grens die het lab heeft opengelaten blijft `null`; er wordt niets afgeleid of standaard ingevuld.

**door lab gerapporteerd**

**name** `string`

Naam van de analyt zoals afgedrukt door het lab. Kan `null` zijn.

**code** `string`

De eigen analytcode van het lab. Kan `null` zijn.

**category** `string`

Sectiekop op het rapport, bijv. `Klinische Chemie`. Kan `null` zijn.

**value** `string`

Waarde zoals afgedrukt. Een string, zodat niet-numerieke resultaten intact blijven (`<0.04`, `negativ`, `1:100`). Kan `null` zijn.

**unit** `string`

Eenheid zoals afgedrukt, bijv. `U/l`. Kan `null` zijn.

**reference\_range** `string`

Referentie-interval zoals afgedrukt, inclusief eenzijdige grenzen: `40 - 129`, `< 50`, `> 55`. Kan `null` zijn.

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

De ondergrens van het lab, niet omgerekend. `null` voor een interval dat het lab aan de onderkant heeft opengelaten.

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

De bovengrens van het lab, niet omgerekend. `null` voor een interval dat het lab aan de bovenkant heeft opengelaten.

**flag** `string`

De afwijkingsmarkering van het lab voor deze regel: `normal`, `high`, `low`, `critical_high`, `critical_low`, `abnormal`. Een code die we niet herkennen wordt doorgegeven zoals het lab deze heeft gestuurd. Kan `null` zijn.

**result\_status** `string`

De resultaatstatus van het lab: `final`, `preliminary`, `correction`, `incomplete`, `partial`, `deleted`, `cannot_be_obtained`. Een `preliminary`-waarde kan nog worden herzien. Een latere `results.updated`[webhook](https://docs.anivahealth.com/nl/concepts/webhooks.md) laat je weten wanneer je opnieuw moet ophalen. Kan `null` zijn.

**comment** `string`

De eigen opmerking van het lab bij deze regel. Kolomopvulling is samengevoegd; de formulering blijft ongewijzigd. Kan `null` zijn.

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

Array van genetische biomarkerresultaten.

**genetisch resultaatobject**

**id** `string`

ID van de labresultaatrij (UUID). Dit blijft gelijk wanneer het lab die rij corrigeert, dus gebruik dit om te upserten. `null` voor een `planned`-resultaat.

**status** `string` *required*

Status van het resultaat. Een van:

* `planned` — besteld, nog niet door het lab geleverd.
* `received` — geleverd door het lab.
* `likely_wrong` — de automatische controle van Aniva of het lid twijfelt aan het genotype. Niet bevestigd. Zie `status_reason`.
* `fault` — geleverd maar bevestigd onjuist; **niet klinisch gebruiken**. Zie `status_reason`.
* `undeliverable` — het lab kon geen genotype bepalen. Zie `status_reason`.

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

Waarom het resultaat twijfelachtig of onbruikbaar is. Gevuld voor `likely_wrong`, `fault` en `undeliverable`, `null` voor elke andere status.

**lab\_code** `string`

Labcode (barcode van het buisje) waaronder het resultaat is vastgelegd. `null` voor een `planned`-resultaat en voor resultaten die het lab zonder code heeft gerapporteerd.

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

Biomarker-ID (gen).

**gene** `string` *required*

Gensymbool (bijv. APOE, MTHFR).

**genotype** `string`

Weergave van het genotype (bijv. E3/E4). Kan `null` zijn.

**clinical\_significance** `string`

Algemene klinische significantie. Een van `pathogenic`, `likely_pathogenic`, `uncertain`, `likely_benign`, `benign`, `high_risk`, `moderate_risk`, `low_risk`, `protective`, `drug_response`, `poor_metabolizer` of `rapid_metabolizer`. Kan `null` zijn.

**risk\_description** `string`

Risicobeschrijving voor dit genotype. Kan `null` zijn.

**tested\_at** `string`

Datum waarop de test is uitgevoerd in `YYYY-MM-DD`-formaat. Kan `null` zijn.

**comment** `string`

Optionele opmerking bij het resultaat. Kan `null` zijn.

**origin** `string`

Wie het document heeft aangeleverd waaruit deze waarde komt, net als `origin` op het document. Een waarde uit een geüpload document is door Aniva uit het bestand gelezen, niet afkomstig uit een labrapport. `null` voor een `planned`-resultaat.

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

Gedetecteerde genetische varianten.

**variantobject**

**name** `string` *required*

Gangbare naam van de variant (bijv. APOE E4).

**clinical\_significance** `string`

Klinische betekenis op variantniveau. Kan `null` zijn.

**description** `string`

Beschrijving van de variant. Kan `null` zijn.

**hgvs\_c** `string`

HGVS-notatie voor coderend DNA. Kan `null` zijn.

**hgvs\_p** `string`

HGVS-eiwitnotatie. Kan `null` zijn.

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

Geassocieerde aandoeningen.

**aandoeningsobject**

**condition** `string` *required*

Naam van de aandoening/ziekte.

**association\_description** `string`

Beschrijving van het verband tussen de variant en de aandoening. Kan `null` zijn.

**badge** `string`

Korte badgetekst voor weergave. Kan `null` zijn.

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

Single-nucleotidevarianten die deze variant definiëren.

**SNV-object**

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

dbSNP-identifier (bijv. rs429358).

**allele** `string` *required*

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

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

Referentieallel in de populatie.

**hgvs\_c** `string`

HGVS-notatie voor coderend DNA. Kan `null` zijn.

**hgvs\_p** `string`

HGVS-eiwitnotatie. Kan `null` zijn.

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

Documenten met laboratoriumrapporten. Gebruik `GET /api/v1/documents/{id}` om elk bestand te downloaden.

**documentobject**

**id** `string` *required*

Bestands-ID (UUID). Geef deze door aan [Document downloaden](https://docs.anivahealth.com/nl/api/documents/download-document.md) om het bestand op te halen.

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

Bestandsnaam. [Document downloaden](https://docs.anivahealth.com/nl/api/documents/download-document.md) stuurt dezelfde naam mee in `Content-Disposition`. Deze bevat een datum, de documenttitel en de labcode, bijv. `20260405 - Quade Befund - 7642001234.pdf`. Gebruik deze alleen voor weergave. Lees de labcode uit `lab_code`, niet uit de naam.

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

Bestandsnaam precies zoals de bron deze aanleverde, bijv. `7642100312_B0012_FA_V.pdf` van het laboratorium of de eigen naam van het lid voor een upload. Aniva past deze niet aan.

**origin** `string` *required*

Wie het bestand aanleverde. Een van `lab` (het laboratorium stuurde het), `member_upload` (het lid uploadde het), `staff_upload` (medewerkers van Aniva uploadden het) of `partner_upload` (jij uploadde het met [Document uploaden](https://docs.anivahealth.com/nl/api/documents/upload-document.md)).

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

Mediatype van het bestand, bijv. `application/pdf`, `image/jpeg` of `text/csv`. De meeste laboratoriumrapporten zijn pdf's.

**etag** `string`

Versie van de bestandsinhoud. Deze verandert zodra de bytes veranderen, dus vergelijk deze met de opgeslagen waarde om te zien of je opnieuw moet downloaden. [Document downloaden](https://docs.anivahealth.com/nl/api/documents/download-document.md) stuurt deze tussen aanhalingstekens als de standaard HTTP-header `ETag`. Kan `null` zijn als het opgeslagen bestand ontbreekt.

**size\_bytes** `integer`

Bestandsgrootte in bytes. Kan `null` zijn als het opgeslagen bestand ontbreekt.

**lab\_code** `string`

Labcode (barcode van het buisje) waarbij het rapport hoort. Kan `null` zijn als het laboratorium er geen heeft vastgelegd.

## Herhaalde aanroepen

Aniva slaat het antwoord van dit endpoint 60 minuten lang op voor elke API-sleutel. Een herhaalde aanroep binnen
deze tijd krijgt het opgeslagen antwoord zolang de thuistestkitbestelling en de resultaten ongewijzigd zijn. Na een wijziging krijg je een nieuw
antwoord. De headers `Cache-Status` en `Age` laten zien dat het antwoord is
opgeslagen en hoe oud het is.

Om direct op de hoogte te zijn van een wijziging, abonneer je je op de webhook-events `home_kit_order.results.updated`, `home_kit_order.results.completed` en `home_kit_order.results.fault`.
Zie [Herhaalde leesaanroepen](https://docs.anivahealth.com/nl/concepts/webhooks.md#herhaalde-leesverzoeken).

## Foutresponsen

| Status | Beschrijving |
| - | - |
| `400` | Ongeldige ID-indeling — de opgegeven waarde is geen geldige UUID. |
| `403` | Verboden — je API-sleutel mist de scope `results_view`, mist zowel `home_kit_orders_view` als `home_kit_orders_manage`, of de thuistestkitbestelling valt buiten je toegangscontext. |
| `404` | Thuistestkitbestelling niet gevonden. |
| `500` | Interne serverfout. |

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