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

# Získat výsledky dokumentu

> Načíst stav a extrahované laboratorní hodnoty tvého nahraného dokumentu

Načti stav a laboratorní hodnoty dokumentu nahraného pomocí
[Nahrát dokument](https://docs.anivahealth.com/cs/api/documents/upload-document.md). Odpověď má stejnou strukturu jako
[Získat laboratorní výsledky](https://docs.anivahealth.com/cs/api/appointments/get-results.md) pro termín. Popis všech polí najdeš v sekci
[Výsledky](https://docs.anivahealth.com/cs/concepts/results.md).

Odpovídají pouze dokumenty nahrané pod skupinou profilů, ze které tvůj klíč může číst výsledky. Každý jiný
dokument vrátí `404`: jeho výsledky si přečti pod termínem nebo objednávkou domácí testovací sady, ze které pochází.

Nemusíš dělat polling. Přihlas se k odběru [webhooků](https://docs.anivahealth.com/cs/concepts/webhooks.md) `document.results.updated` nebo `document.results.completed`
a zavolej tento endpoint, až přijde událost.

Vyžaduje scope `results_view` pro skupinu profilů, pod kterou byl dokument nahrán.

## Požadavek

### Parametry cesty

**id** `string` *required*

ID dokumentu (UUID) z odpovědi při nahrání.

### Hlavičky

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

`ETag` z předchozí odpovědi. Když se nic nezměnilo, API odpoví `304 Not Modified` bez
těla.

## Odpověď

Při úspěchu API vrátí `200 OK` s objektem výsledků a hlavičkou `ETag`.

**status** `string` *required*

Jedna z hodnot:

* `in_progress` — Aniva extrahuje hodnoty.
* `completed` — extrakce dokončena.
* `fault` — extrakce selhala.
* `stored` — dokument nemá žádné hodnoty: byl nahrán bez `extract_results`, nebo neobsahuje žádné
  laboratorní výsledky. Stav `stored` je konečný: žádný webhook `document.results.completed` už nepřijde.

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

Extrahované hodnoty. Každá hodnota má `origin: partner_upload`. Zpráva s několika daty odběru
dá každé hodnotě její vlastní `tested_at`. Nikdy není `planned`: nahrání nic neobjednává.

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

Genetické výsledky. U nahraného dokumentu jsou zatím prázdné.

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

Samotný nahraný dokument.

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

Jeden záznam pro nahrání. `lab_code` je `null`.

## Chybové odpovědi

| Stav | Popis |
| - | - |
| `304` | Nezměněno — etag v `If-None-Match` stále odpovídá. Bez těla. |
| `400` | Neplatný formát ID. |
| `403` | Tvůj API klíč nemá scope `results_view`. |
| `404` | Pod žádnou z tvých skupin profilů není nahraný dokument s tímto ID. |
| `500` | Interní chyba serveru. |

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