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

# Pobierz dokument

> Pobierz dokument z raportem laboratoryjnym według ID pliku

Pobierz dokument raportu laboratoryjnego na podstawie ID pliku. Zwraca surowe bajty pliku z odpowiednim nagłówkiem `Content-Type`. Identyfikatory dokumentów pochodzą z tablicy `documents` w odpowiedzi [Pobierz wyniki laboratoryjne](https://docs.anivahealth.com/pl/api/appointments/get-results.md).

Wymaga zakresu `results_view`.

> [!NOTE]
>
> Dostęp jest weryfikowany względem profilu, do którego należy dokument. Dokument przesłany za pomocą [Prześlij dokument](https://docs.anivahealth.com/pl/api/documents/upload-document.md) jest weryfikowany względem grupy profili, w której został przesłany.

## Żądanie

### Parametry ścieżki

**id** `string` *required*

ID pliku (UUID) z tablicy `documents` w odpowiedzi z wynikami wizyty.

## Odpowiedź

W razie powodzenia API zwraca `200 OK` z bajtami pliku i czterema nagłówkami. Każdy nagłówek zawiera pole z tablicy `documents`:

| Nagłówek | Pole | Przykład |
| - | - | - |
| `Content-Type` | `content_type` | `application/pdf` |
| `Content-Disposition` | `file_name` | `attachment; filename="20260405 - Quade Befund - 7642001234.pdf"` |
| `ETag` | `etag` (w cudzysłowie) | `"56104b36f860cfd5b41efc716fdf7b6f"` |
| `Original-File-Name` | `original_file_name` | `7642001234_B0012_FA_E.pdf` |

`Original-File-Name` to UTF-8 zakodowane procentowo, ponieważ nagłówek nie może zawierać wszystkich znaków, które mogą wystąpić w nazwie przesłanego pliku. Zdekoduj go za pomocą `decodeURIComponent` lub odpowiednika.

`ETag` i `If-None-Match` to standardowe nagłówki buforowania HTTP (RFC 9110). Wyślij zapisany `etag` w nagłówku `If-None-Match`, aby pominąć niezmieniony plik. API odpowie wtedy `304 Not Modified` bez treści.

## Odpowiedzi z błędami

| Status | Opis |
| - | - |
| `304` | Niezmodyfikowano — etag z `If-None-Match` nadal pasuje do pliku. Brak treści. |
| `400` | Nieprawidłowy format ID — podana wartość nie jest poprawnym UUID. |
| `403` | Brak dostępu — twój klucz API nie ma uprawnień do tej operacji lub dokument znajduje się poza twoim kontekstem dostępu. |
| `404` | Nie znaleziono dokumentu. |
| `500` | Wewnętrzny błąd serwera. |

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