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

# Lataa dokumentti

> Lataa laboratorioraporttidokumentti tiedoston ID:llä

Lataa laboratorioraportti sen tiedostotunnuksella. Palauttaa tiedoston raakatavut asianmukaisella `Content-Type`-otsakkeella. Asiakirjatunnukset saadaan [Hae laboratoriotulokset](https://docs.anivahealth.com/fi/api/appointments/get-results.md) -vastauksen `documents`-taulukosta.

Vaatii `results_view`-käyttöoikeuden.

> [!NOTE]
>
> Käyttöoikeus varmennetaan asiakirjan omistavaa profiilia vasten. Asiakirja, jonka lähetit [Lähetä asiakirja](https://docs.anivahealth.com/fi/api/documents/upload-document.md) -päätepisteellä, varmennetaan sitä profiiliryhmää vasten, johon se lähetettiin.

## Pyyntö

### Polkuparametrit

**id** `string` *required*

Tiedostotunnus (UUID) ajanvarauksen tulosvastauksen `documents`-taulukosta.

## Vastaus

Onnistuessaan API palauttaa tilan `200 OK`, tiedoston tavut ja neljä otsaketta. Jokainen otsake sisältää yhden `documents`-taulukon kentän:

| Otsake | Kenttä | Esimerkki |
| - | - | - |
| `Content-Type` | `content_type` | `application/pdf` |
| `Content-Disposition` | `file_name` | `attachment; filename="20260405 - Quade Befund - 7642001234.pdf"` |
| `ETag` | `etag` (lainausmerkeissä) | `"56104b36f860cfd5b41efc716fdf7b6f"` |
| `Original-File-Name` | `original_file_name` | `7642001234_B0012_FA_E.pdf` |

`Original-File-Name` on prosenttikoodattua UTF-8-muotoa, koska otsake ei voi sisältää kaikkia merkkejä, joita lähetetyssä tiedostonimessä voi olla. Pura se funktiolla `decodeURIComponent` tai vastaavalla.

`ETag` ja `If-None-Match` ovat standardin mukaisia HTTP-välimuistiotsakkeita (RFC 9110). Lähetä tallentamasi `etag` `If-None-Match`-otsakkeessa ohittaaksesi muuttumattoman tiedoston. API vastaa silloin `304 Not Modified` ilman runkoa.

## Virhevastaukset

| Tila | Kuvaus |
| - | - |
| `304` | Ei muutettu — `If-None-Match`-otsakkeen etag vastaa yhä tiedostoa. Ei runkoa. |
| `400` | Virheellinen tunnuksen muoto — annettu arvo ei ole kelvollinen UUID. |
| `403` | Kielletty — API-avaimellasi ei ole oikeutta tähän toimintoon tai asiakirja on käyttöoikeusalueesi ulkopuolella. |
| `404` | Asiakirjaa ei löytynyt. |
| `500` | Sisäinen palvelinvirhe. |

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

```text 200 theme={null}
(Binary file content — save the response to a file)
```

```json 404 theme={null}
{
  "error": "Document not found"
}
```


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