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

# Descarrega un document

> Descarrega un document d'informe de laboratori per ID de fitxer

Descarrega un document d'informe de laboratori pel seu ID de fitxer. Retorna els bytes en brut del fitxer amb la capçalera `Content-Type` corresponent. Els ID dels documents s'obtenen de la matriu `documents` de la resposta d'[Obtén els resultats de laboratori](https://docs.anivahealth.com/ca/api/appointments/get-results.md).

Requereix l'àmbit `results_view`.

> [!NOTE]
>
> L'accés es valida respecte al perfil propietari del document. Un document que hagis pujat amb [Puja un document](https://docs.anivahealth.com/ca/api/documents/upload-document.md) es valida respecte al grup de perfils en què es va pujar.

## Sol·licitud

### Paràmetres de ruta

**id** `string` *required*

ID del fitxer (UUID) de la matriu `documents` a la resposta de resultats de la cita.

## Resposta

Si té èxit, l'API retorna `200 OK` amb els bytes del fitxer i quatre capçaleres. Cada capçalera conté un camp de la matriu `documents`:

| Capçalera | Camp | Exemple |
| - | - | - |
| `Content-Type` | `content_type` | `application/pdf` |
| `Content-Disposition` | `file_name` | `attachment; filename="20260405 - Quade Befund - 7642001234.pdf"` |
| `ETag` | `etag` (entre cometes) | `"56104b36f860cfd5b41efc716fdf7b6f"` |
| `Original-File-Name` | `original_file_name` | `7642001234_B0012_FA_E.pdf` |

`Original-File-Name` està codificat en UTF-8 amb codificació de percentatge, perquè una capçalera no admet tots els caràcters que pot contenir un nom pujat. Descodifica'l amb `decodeURIComponent` o un equivalent.

`ETag` i `If-None-Match` són les capçaleres estàndard de memòria cau HTTP (RFC 9110). Envia l'`etag` que tens a `If-None-Match` per ometre un fitxer sense canvis. Aleshores, l'API respon `304 Not Modified` sense cos.

## Respostes d'error

| Estat | Descripció |
| - | - |
| `304` | No modificat — l'etag d'`If-None-Match` continua coincidint amb el fitxer. Sense cos. |
| `400` | Format d'ID no vàlid — el valor indicat no és un UUID vàlid. |
| `403` | Prohibit — la teva clau API no té accés a aquesta operació o el document queda fora del teu context d'accés. |
| `404` | No s'ha trobat el document. |
| `500` | Error intern del servidor. |

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