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

# Resultaten

> Hoe labresultaten en documenten werken in de Aniva API: biomarkerwaarden, referentiebereiken, labrapporten en webhooks voor resultaten.

Nadat een bloedafname is bevestigd en het lab de monsters heeft verwerkt, worden de resultaten beschikbaar op de afspraak. Resultaten worden opgehaald via `GET /api/v1/appointments/{id}/results` en bevatten klinische biomarkerresultaten, genetische biomarkerresultaten en downloadbare labrapporten.

## Status van resultaten

Het `status`-veld op het hoogste niveau van de resultatenrespons geeft de algehele verwerkingsvoortgang aan:

| Status | Betekenis |
| - | - |
| `in_progress` | Sommige inzendingen worden nog door het lab verwerkt. |
| `completed` | Alle inzendingen zijn afgesloten en minstens één heeft gerapporteerd. |
| `fault` | Elke inzending is zonder rapportage mislukt. Er staan geen resultaten meer open. |

Afzonderlijke resultaten binnen de respons hebben hun eigen status per resultaat (zie hieronder), zodat je al deelresultaten kunt tonen terwijl de algehele status nog `in_progress` is.

Abonneer je op [webhooks](https://docs.anivahealth.com/nl/concepts/webhooks.md) om te weten wanneer resultaten veranderen. `appointment.results.updated` wordt geactiveerd bij elke wijziging van de resultatenbody en `appointment.results.completed` wordt geactiveerd wanneer de status op het hoogste niveau naar `completed` gaat. Bestellingen voor thuistestkits sturen dezelfde events met het voorvoegsel `home_kit_order.`. Elk event bevat de URL om de resultaten op te halen. Je kunt dit endpoint nog steeds pollen om te synchroniseren.

De `submissions`-array splitst de status op het hoogste niveau op per laboratoriumaanvraag. Een bloedafname die meerdere buisjes of meerdere laboratoria omvat, heeft meerdere vermeldingen, elk met de `lab_code` (buisbarcode) waaronder deze is ingediend en een eigen status `in_progress` / `completed` / `fault`. Een `fault`-vermelding is door het lab afgewezen of stopgezet en zal nooit rapporteren: het monster is vaak naar een ander laboratorium verplaatst, dat vervolgens zijn eigen vermelding aanmaakt. De status op het hoogste niveau is `completed` wanneer elke vermelding is afgesloten en minstens één heeft gerapporteerd. Elk ontvangen resultaat en elk document heeft dezelfde `lab_code`, zodat je kunt zien uit welk buisje een waarde komt.

## Klinische resultaten

Klinische resultaten zijn standaard metingen van bloedbiomarkers — zoals vitamine D-waarden, cholesterol, schildklierhormonen enzovoort.

Elk klinisch resultaat bevat:

* **`id`** — de identifier van de labresultaatrij. Deze blijft hetzelfde wanneer het lab die rij corrigeert, dus gebruik deze om te upserten. `null` voor een `planned`-resultaat.
* **`biomarker_name`** en **`category`** — wat er is gemeten en de categorie (bijv. Vitamines, Hormonen).
* **`lab_code`** — de labcode (buisbarcode) waaronder het resultaat is ingediend, een van de labcodes van de bestelling. `null` voor een `planned`-resultaat en voor resultaten die het lab zonder code heeft gerapporteerd.
* **`value`** en **`value_operator`** — de daadwerkelijke meting. De operator is `eq` (gelijk aan) voor exacte waarden, of `lt`/`gt` wanneer het lab een waarde onder of boven het meetbare bereik rapporteert.
* **`unit`** — de meeteenheid (bijv. ng/mL, µIU/mL).
* **`reference_range_lab`** — normale en optimale min/max-grenzen zoals gerapporteerd door het lab voor dit resultaat, omgerekend naar dezelfde schaal als `value`. Een grens die het lab openlaat is `null`, dus een eenzijdig interval zoals `< 50` komt binnen als `normal_min: null, normal_max: 50`. Elk resultaat bevat het interval waartegen het is gemeten, zodat een patiënt met resultaten van meerdere bloedafnames of labs per resultaat het juiste interval krijgt.
* **`reference_range_lab_absent_reason`** — waarom `reference_range_lab` `null` is. `null` wanneer het bereik aanwezig is, en bij een `planned`-resultaat. Zie [Wanneer er geen labbereik is](#wanneer-er-geen-labbereik-is).
* **`aniva_range`** — 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 uitsluitend ter informatie. Ze zijn geen medisch advies, geen diagnose en geen beoordeling van het resultaat. Aniva plaatst er geen markering bij. Gebruik `reference_range_lab` als norm voor het resultaat. `null` wanneer je sleutel de scope `aniva_ranges_view` niet heeft, of wanneer Aniva geen waarden voor deze biomarker heeft.
* **`tested_at`** — de datum waarop de test is uitgevoerd.
* **`comment`** — vrije-tekstopmerking van het lab bij dit specifieke resultaat (bijv. toelichting op het referentiebereik, waarschuwingen over de monsterkwaliteit). `null` wanneer het lab er geen heeft toegevoegd.
* **`status_reason`** — waarom een `likely_wrong`-resultaat twijfelachtig is, of een `fault`- of `undeliverable`-resultaat onbruikbaar is. `null` voor elke andere status. Anders dan `comment`, wat de eigen opmerking van het lab is en bij foutieve resultaten vaak leeg is.
* **`origin`** — wie het document heeft aangeleverd waaruit de waarde afkomstig is, dezelfde waarden als het documentveld `origin` hieronder. Een waarde uit een geüpload document (`member_upload`, `staff_upload`, `partner_upload`) is afkomstig van Aniva die het bestand uitleest, niet van een labrapport: controleer deze met het bestand voor klinisch gebruik. `null` voor een `planned`-resultaat.
* **`lab_reported`** — de eigen rapportregel van het uitvoerende lab, letterlijk en niet omgerekend. Zie hieronder.

### Aniva-bereiken

`aniva_range` bevat vergelijkingswaarden die Aniva heeft samengesteld uit gepubliceerde bronnen en
eigen selectie. De bereiken verschillen per leeftijd, geslacht en zwangerschapsweek.
`sources` vermeldt de gepubliceerde bronnen die Aniva voor de waarden heeft vastgelegd. De lijst kan leeg zijn.

> [!WARNING]
>
> De waarden zijn algemene informatie. Ze zijn geen medisch advies, geen diagnose, geen
> medische bevinding en geen beoordeling van een resultaat. Aniva biedt ze niet aan als medisch
> hulpmiddel. Aniva vergelijkt een resultaat er niet mee en plaatst er geen markering bij.
> `reference_range_lab` en de beoordeling door een arts blijven de norm voor een resultaat.

Regels voor je product:

* Toon het Aniva-bereik alleen naast het bereik van het laboratorium, nooit in plaats daarvan.
* Als je een markering, een waarschuwing of een aanbeveling afleidt uit het Aniva-bereik, doe je dit uit
  eigen naam en op eigen verantwoordelijkheid.
* Toon de melding uit je overeenkomst met Aniva overal waar je het Aniva-bereik toont.

Onderteken de korte overeenkomst voor Aniva-bereiken om toegang te krijgen. We voegen dan de
scope `aniva_ranges_view` toe aan je sleutel. De waarden kunnen zonder voorafgaande kennisgeving veranderen.

### Genormaliseerde waarden versus de eigen regel van het lab

`value`, `unit` en `reference_range_lab` zijn genormaliseerd: we rekenen elke meting om naar de canonieke eenheid van de biomarker en rapporteren deze onder onze eigen biomarkernaam, zodat dezelfde analyt vergelijkbaar is tussen labs en door de tijd heen. Dat is wat je wilt voor trends en voor vergelijking tussen labs, en het is niet wat een beoordelende arts ziet op de pdf van het lab — alkalische fosfatase afgedrukt als `48 U/l (40 - 129)` bereikt je als `0.8 µkat/L`.

`lab_reported` bevat die afgedrukte regel daarnaast: de analytnaam en -code van het lab, de waarde en eenheid zoals afgedrukt, het referentie-interval zowel als tekst (`< 50`, `> 55`, `40 - 129`) als de eigen niet-omgerekende grenzen van het lab, plus de afwijkingsmarkering, resultaatstatus en opmerking.

Gebruik `lab_reported` wanneer iemand je gegevens vergelijkt met het labrapport, en de canonieke velden voor alles wat wordt berekend. Alleen velden die het lab daadwerkelijk heeft verzonden zijn gevuld; niets in `lab_reported` is afgeleid, standaard ingesteld of omgerekend, en het hele object is `null` wanneer we geen ruwe gegevens voor een resultaat hebben.

### Wanneer er geen labbereik is

Wanneer `reference_range_lab` `null` is, laat `reference_range_lab_absent_reason` je zien waarom:

| Waarde | Betekenis | Tonen |
| - | - | - |
| `not_provided` | Er bestaat geen bereik. Het lab heeft er geen gestuurd. | "Niet van toepassing" |
| `lab_text_only` | Het lab heeft alleen tekst afgedrukt, zoals een streefwaarde, een risicocategorie of een bereik per levensfase. | De tekst in `lab_reported.reference_range` |
| `not_measured` | Het resultaat is `undeliverable`, dus er is geen waarde om te vergelijken. | De `status_reason` |

Sommige labs drukken een streefwaarde of een risicocategorie af in plaats van een referentiebereik, bijvoorbeeld
`Ziel: <200. >240 hoch` of `<5.7 neg >=6.5 pos`. Deze komen niet in `reference_range_lab`, dus de
grenzen ervan zijn `null` en de reden is `lab_text_only`. Toon de afgedrukte tekst letterlijk.

Een eenzijdig bereik zoals `< 20` is wel een bereik. Het komt binnen in `reference_range_lab` met één grens op
`null` en de reden is `null`. Houd de open kant open wanneer je het toont.

### Statussen van klinische resultaten

| Status | Betekenis |
| - | - |
| `planned` | De test is besteld, maar er zijn nog geen resultaten van het lab binnen. |
| `received` | Het lab heeft een resultaat teruggestuurd. |
| `corrected` | Een menselijke beoordelaar heeft de door het lab gerapporteerde waarde herzien. |
| `likely_wrong` | De automatische controle van Aniva of het lid twijfelt aan de waarde. Niet bevestigd: toon deze niet zonder beoordeling als bevinding. Zie `status_reason`. |
| `fault` | Het lab heeft een resultaat geleverd dat bevestigd onjuist is — **niet klinisch gebruiken**. `value` bevat nog steeds het onjuiste getal; zie `status_reason`. |
| `undeliverable` | Het lab kon geen waarde opleveren. `value` is `null`; zie `status_reason`. |

> [!TIP]
>
> Gebruik bij het tonen van resultaten aan patiënten direct het veld `value` — dit bevat al de
> gecorrigeerde waarde wanneer die bestaat.

> [!WARNING]
>
> Presenteer een `fault`-resultaat nooit als bevinding — de `value` is ingevuld, maar is bevestigd onjuist.

## Genetische resultaten

Genetische resultaten zijn bevindingen op genniveau uit DNA-analyse. Elk resultaat hoort bij een gen (bijv. APOE, MTHFR) en bevat:

* **`id`** — de identifier van de labresultaatrij. Deze blijft hetzelfde wanneer het lab die rij corrigeert, dus gebruik deze om te upserten. `null` voor een `planned`-resultaat.
* **`gene`** — het gensymbool.
* **`lab_code`** — de labcode (buisbarcode) waaronder het resultaat is ingediend. `null` voor een `planned`-resultaat en voor resultaten die het lab zonder code heeft gerapporteerd.
* **`genotype`** — het gedetecteerde genotype (bijv. E3/E4).
* **`clinical_significance`** — een op ACMG gebaseerde classificatie van de bevinding.
* **`risk_description`** — een leesbare uitleg van wat het genotype betekent.
* **`comment`** — vrije-tekstopmerking van het lab bij dit specifieke resultaat. `null` wanneer het lab er geen heeft toegevoegd.
* **`status_reason`** — waarom een `likely_wrong`-resultaat twijfelachtig is, of een `fault`- of `undeliverable`-resultaat onbruikbaar is. `null` voor elke andere status.
* **`origin`** — wie het document heeft aangeleverd waaruit de waarde afkomstig is, net als bij klinische resultaten.
* **`variants`** — de specifieke gedetecteerde genetische varianten, elk met details op SNV-niveau.

### Waarden voor klinische significantie

| Waarde | Categorie |
| - | - |
| `pathogenic`, `likely_pathogenic` | Ziekteverwekkend of waarschijnlijk ziekteverwekkend |
| `uncertain` | Variant van onzekere betekenis (VUS) |
| `likely_benign`, `benign` | Niet ziekteverwekkend |
| `high_risk`, `moderate_risk`, `low_risk` | Classificatie van risiconiveau |
| `protective` | Beschermende variant |
| `drug_response`, `poor_metabolizer`, `rapid_metabolizer` | Farmacogenomische bevindingen |

### Statussen van genetische resultaten

| Status | Betekenis |
| - | - |
| `planned` | De test is aangevraagd, maar de resultaten zijn nog niet binnen. |
| `received` | Het lab heeft een resultaat teruggestuurd. |
| `likely_wrong` | De automatische controle van Aniva of het lid twijfelt aan het genotype. Niet bevestigd. Zie `status_reason`. |
| `fault` | Het lab heeft een resultaat geleverd waarvan is bevestigd dat het onjuist is — **niet klinisch gebruiken**. Zie `status_reason`. |
| `undeliverable` | Het lab kon geen genotype bepalen. Zie `status_reason`. |

### Structuur van varianten

Elk genetisch resultaat bevat een `variants`-array. Elke variant bevat:

* **`name`** — gangbare naam (bijv. APOE E4).
* **`clinical_significance`** — klinische betekenis op variantniveau (kan afwijken van de betekenis op genniveau).
* **`conditions`** — bijbehorende ziekten/aandoeningen met beschrijvingen.
* **`snvs`** — de onderliggende single-nucleotidevarianten, elk met `rs_id`, `allele`, `reference_allele` en optionele HGVS-notatie.

## Documenten

De `documents`-array in de resultatenrespons bevat verwijzingen naar downloadbare labrapportbestanden. Elk document heeft:

* **`id`** — een bestands-UUID. Geef deze door aan `GET /api/v1/documents/{id}` om het bestand te downloaden.
* **`file_name`** — de bestandsnaam, dezelfde die de download meestuurt (bijv. `20260405 - Quade Befund - 7642001234.pdf`).
* **`original_file_name`** — de bestandsnaam precies zoals het lab of de uploader die heeft aangeleverd (bijv. `7642001234_B0012_FA_E.pdf`).
* **`origin`** — wie het bestand heeft aangeleverd: `lab`, `member_upload`, `staff_upload` of `partner_upload` (je hebt het geüpload met [Document uploaden](https://docs.anivahealth.com/nl/api/documents/upload-document.md)).
* **`content_type`** — het mediatype van het bestand (bijv. `application/pdf`). De meeste rapporten zijn pdf's. Geüploade scans kunnen afbeeldingen of csv-bestanden zijn.
* **`etag`** — de versie van de bestandsinhoud; deze verandert zodra de bytes veranderen. Sla deze op en download alleen opnieuw als deze verandert. Dit is de standaard HTTP entity tag, zoals gebruikt door S3 of Google Cloud Storage.
* **`size_bytes`** — de bestandsgrootte in bytes.
* **`lab_code`** — de labcode (buisbarcode) waarbij het rapport hoort; `null` als het lab er geen heeft opgegeven.

> [!NOTE]
>
> Toegang tot documenten wordt gecontroleerd aan de hand van het profiel dat eigenaar is van het document.

## Resultaten naar de klant e-mailen

Je kunt de klant per e-mail laten weten dat de resultaten klaarstaan. Roep
[Resultaten e-mailen](https://docs.anivahealth.com/nl/api/appointments/email-results.md) aan voor een afspraak, of
[Resultaten e-mailen](https://docs.anivahealth.com/nl/api/home-kit-orders/email-results.md) voor een thuistestkitbestelling. Elke aanroep verstuurt één e-mail.
Aanroepen worden niet gededupliceerd.

* De e-mail gaat naar de `email` van het profiel. Een placeholder-adres met `@aniva.email` wordt geweigerd.
* De e-mail toont de naam en het logo van de primaire profielgroep van het profiel.
* De e-mail is in de `language` van het profiel, standaard Engels.
* Zet `with_reports` op `true` om de labrapporten bij te voegen.
* Voeg `note` toe om een persoonlijke notitie in de e-mail te tonen, maximaal 1.000 tekens.

Als het profiel transactionele e-mails heeft uitgeschakeld, geeft de aanroep `409` terug met de reden
`unsubscribed`. Om ze weer in te schakelen, stel je `transactional_emails_enabled` in op `true` met
[Profiel bijwerken](https://docs.anivahealth.com/nl/api/profiles/update-profile.md).

## E-mails zodra resultaten klaarstaan

Je kunt een e-mail ontvangen wanneer de resultaten van een boeking klaarstaan. Stel `results_ready_emails` in op maximaal 5
adressen bij [Afspraak aanmaken](https://docs.anivahealth.com/nl/api/appointments/create-appointment.md) of
[Thuistestkitbestelling aanmaken](https://docs.anivahealth.com/nl/api/home-kit-orders/create-home-kit.md). Wijzig de lijst later met
[Afspraak bijwerken](https://docs.anivahealth.com/nl/api/appointments/update-appointment.md) of
[Thuistestkitbestelling bijwerken](https://docs.anivahealth.com/nl/api/home-kit-orders/update-home-kit.md); `[]` schakelt de e-mails uit.

* Vraag ons om standaard e-mailadressen voor jouw profielgroep in te stellen. Een boeking die zonder
  `results_ready_emails` wordt aangemaakt, krijgt deze adressen. Een lijst vervangt ze voor die boeking, dus neem je
  standaard e-mailadres op om het te behouden. `[]` verstuurt geen e-mail.
* Elk adres ontvangt één e-mail zodra elk labresultaat van de boeking definitief is.
* Een adres dat wordt toegevoegd nadat de resultaten definitief zijn, ontvangt de e-mail direct.
* De e-mail linkt naar de resultatenpagina in het Aniva-beheerpaneel. De klant ontvangt deze niet.
* Je sleutel heeft `results_view`-toegang tot de patiënt nodig. Zonder die toegang geeft het verzoek `403` terug.

## Resultaten tonen in je app

[Embed-sessie aanmaken](https://docs.anivahealth.com/nl/api/profiles/create-embed-session.md) geeft een eenmalige URL terug voor een alleen-lezen
resultatenpagina. Open deze in een WebView van je app, zodat de patiënt de resultaten ziet zonder in te loggen.

* Je sleutel heeft de scopes `embed` en `results_view` nodig voor de patiënt. Vraag Aniva om de
  `embed`-scope.
* Roep dit vanaf je server aan telkens wanneer de patiënt de resultaten opent. De URL werkt één keer en is
  5 minuten geldig, waarna de pagina een sessie van 60 minuten aanhoudt.
* `route` opent een van de pagina's die we beschikbaar stellen: de biomarkerlijst, één biomarker of de 3D Twin.
* `appearance` stelt het thema in, de kleur van knoppen en links, en of je logo wordt getoond.
* `report` beperkt de pagina tot één afspraak, één thuistestkitbestelling of één labrapport dat je
  hebt geüpload met `POST /api/v1/documents`. De patiënt ziet dan alleen de resultaten van dat rapport.
* De pagina toont alleen labresultaten, net als deze API. Er worden geen bestanden, geen chat en geen instellingen getoond.

## Voorbeeld van een resultatenrespons

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