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

# Scarica documento

> Scarica un referto di laboratorio tramite ID del file

Scarica un referto di laboratorio tramite il suo ID file. Restituisce i byte grezzi del file con l'header `Content-Type` appropriato. Gli ID dei documenti si ottengono dall'array `documents` nella risposta di [Ottieni risultati di laboratorio](https://docs.anivahealth.com/it/api/appointments/get-results.md).

Richiede lo scope `results_view`.

> [!NOTE]
>
> L'accesso viene verificato in base al profilo proprietario del documento. Un documento caricato con [Carica documento](https://docs.anivahealth.com/it/api/documents/upload-document.md) viene verificato in base al gruppo di profili in cui è stato caricato.

## Richiesta

### Parametri di percorso

**id** `string` *required*

ID file (UUID) dall'array `documents` nella risposta dei risultati dell'appuntamento.

## Risposta

In caso di successo, l'API restituisce `200 OK` con i byte del file e quattro header. Ogni header contiene un campo dell'array `documents`:

| Header | Campo | Esempio |
| - | - | - |
| `Content-Type` | `content_type` | `application/pdf` |
| `Content-Disposition` | `file_name` | `attachment; filename="20260405 - Quade Befund - 7642001234.pdf"` |
| `ETag` | `etag` (tra virgolette) | `"56104b36f860cfd5b41efc716fdf7b6f"` |
| `Original-File-Name` | `original_file_name` | `7642001234_B0012_FA_E.pdf` |

`Original-File-Name` è in UTF-8 con codifica percentuale, perché un header non può contenere tutti i caratteri che possono comparire in un nome caricato. Decodificalo con `decodeURIComponent` o un equivalente.

`ETag` e `If-None-Match` sono gli header HTTP standard per la cache (RFC 9110). Invia l'`etag` che hai in `If-None-Match` per saltare un file invariato. L'API risponde quindi con `304 Not Modified` senza body.

## Risposte di errore

| Stato | Descrizione |
| - | - |
| `304` | Non modificato — l'etag di `If-None-Match` corrisponde ancora al file. Nessun body. |
| `400` | Formato dell'ID non valido — il valore fornito non è un UUID valido. |
| `403` | Accesso negato — la tua chiave API non ha accesso a questa operazione oppure il documento è fuori dal tuo contesto di accesso. |
| `404` | Documento non trovato. |
| `500` | Errore interno del server. |

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