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

# Documentresultaten ophalen

> Lees de status en de geëxtraheerde labwaarden van een document dat je hebt geüpload

Lees de status en de labwaarden van een document dat je hebt geüpload met
[Document uploaden](https://docs.anivahealth.com/nl/api/documents/upload-document.md). De response heeft dezelfde structuur als
[Labresultaten ophalen](https://docs.anivahealth.com/nl/api/appointments/get-results.md) voor een afspraak. Zie
[Resultaten](https://docs.anivahealth.com/nl/concepts/results.md) voor elk veld.

Alleen documenten die zijn geüpload onder een profielgroep waarvoor je sleutel resultaten mag lezen, geven een antwoord. Elk ander
document geeft `404` terug: lees de resultaten ervan via de afspraak of thuistestkit-bestelling waaruit het afkomstig is.

Je hoeft niet te pollen. Abonneer je op de `document.results.updated`- of `document.results.completed`-
[webhooks](https://docs.anivahealth.com/nl/concepts/webhooks.md) en roep dit endpoint aan zodra er een event binnenkomt.

Vereist de `results_view`-scope voor de profielgroep waaronder het document is geüpload.

## Verzoek

### Padparameters

**id** `string` *required*

Document-ID (UUID) uit de uploadresponse.

### Headers

**If-None-Match** `string`

De `ETag` van een eerdere response. Als er niets is veranderd, antwoordt de API met `304 Not Modified`
zonder body.

## Respons

Bij succes geeft de API `200 OK` terug met het resultatenobject en een `ETag`-header.

**status** `string` *required*

Een van:

* `in_progress` — Aniva is bezig de waarden uit te lezen.
* `completed` — uitlezen is klaar.
* `fault` — uitlezen is mislukt.
* `stored` — het document bevat geen waarden: je hebt het geüpload zonder `extract_results`, of het bevat geen
  labresultaten. `stored` is definitief: er volgt geen `document.results.completed`-webhook.

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

De uitgelezen waarden. Elke waarde heeft `origin: partner_upload`. Bij een rapport met meerdere
afnamedatums krijgt elke waarde een eigen `tested_at`. Nooit `planned`: een upload bestelt niets.

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

Genetische resultaten. Op dit moment leeg voor een geüpload document.

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

Het geüploade document zelf.

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

Eén item voor de upload. `lab_code` is `null`.

## Foutresponsen

| Status | Beschrijving |
| - | - |
| `304` | Niet gewijzigd — de `If-None-Match`-etag komt nog overeen. Geen body. |
| `400` | Ongeldig ID-formaat. |
| `403` | Je API-sleutel mist de `results_view`-scope. |
| `404` | Er is geen document met dit ID geüpload onder een van jouw profielgroepen. |
| `500` | Interne serverfout. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/documents/f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c/results \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "status": "stored",
  "submissions": [{ "lab_code": null, "status": "completed" }],
  "clinical_results": [],
  "genetic_results": [],
  "documents": [
    {
      "id": "f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c",
      "file_name": "20261023 - Arztbrief.pdf",
      "original_file_name": "arztbrief.pdf",
      "origin": "partner_upload",
      "content_type": "application/pdf",
      "etag": "56104b36f860cfd5b41efc716fdf7b6f",
      "size_bytes": 182311,
      "lab_code": null
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.