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

# Hae dokumentin tulokset

> Lue palveluun lataamasi dokumentin tila ja siitä poimitut laboratorioarvot

Lue [Lähetä asiakirja](https://docs.anivahealth.com/fi/api/documents/upload-document.md) -päätepisteellä lähettämäsi asiakirjan tila ja
laboratorioarvot. Vastauksella on sama rakenne kuin ajanvarauksen
[Hae laboratoriotulokset](https://docs.anivahealth.com/fi/api/appointments/get-results.md) -vastauksella. Katso kaikki kentät sivulta
[Tulokset](https://docs.anivahealth.com/fi/concepts/results.md).

Vastauksen saa vain asiakirjoista, jotka on lähetetty profiiliryhmään, jonka tuloksia avaimesi lukee. Kaikki muut
asiakirjat palauttavat tilan `404`: lue niiden tulokset sen ajanvarauksen tai kotitestipakkaustilauksen kautta, joka ne tuotti.

Sinun ei tarvitse kysellä tilaa toistuvasti. Tilaa `document.results.updated`- tai
`document.results.completed`-[webhookit](https://docs.anivahealth.com/fi/concepts/webhooks.md) ja kutsu tätä päätepistettä, kun tapahtuma saapuu.

Vaatii `results_view`-scopen profiiliryhmälle, johon asiakirja lähetettiin.

## Pyyntö

### Polkuparametrit

**id** `string` *required*

Asiakirjan tunnus (UUID) lähetysvastauksesta.

### Otsakkeet

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

Aiemman vastauksen `ETag`. Kun mikään ei ole muuttunut, API vastaa `304 Not Modified` ilman
runkoa.

## Vastaus

Onnistuessaan API palauttaa tilan `200 OK`, tulosobjektin ja `ETag`-otsakkeen.

**status** `string` *required*

Jokin seuraavista:

* `in_progress` — Aniva poimii arvoja.
* `completed` — poiminta valmistui.
* `fault` — poiminta epäonnistui.
* `stored` — asiakirjassa ei ole arvoja: lähetit sen ilman `extract_results`-kenttää tai siinä ei ole
  laboratoriotuloksia. `stored` on lopullinen tila: sitä ei seuraa `document.results.completed`-webhook.

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

Poimitut arvot. Jokaisella arvolla on `origin: partner_upload`. Jos raportissa on useita
näytepäiviä, kukin arvo saa oman `tested_at`-arvonsa. Ei koskaan `planned`: lähetys ei tilaa mitään.

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

Geneettiset tulokset. Tällä hetkellä tyhjä lähetetylle asiakirjalle.

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

Itse lähetetty asiakirja.

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

Yksi merkintä lähetykselle. `lab_code` on `null`.

## Virhevastaukset

| Tila | Kuvaus |
| - | - |
| `304` | Ei muutettu — `If-None-Match`-otsakkeen etag täsmää yhä. Ei runkoa. |
| `400` | Virheellinen tunnuksen muoto. |
| `403` | API-avaimeltasi puuttuu `results_view`-scope. |
| `404` | Yhdessäkään profiiliryhmistäsi ei ole tällä tunnuksella lähetettyä asiakirjaa. |
| `500` | Sisäinen palvelinvirhe. |

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