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

# Télécharger un document

> Télécharger un rapport de laboratoire par ID de fichier

Télécharge un compte rendu de laboratoire à partir de son ID de fichier. Renvoie les octets bruts du fichier avec l'en-tête `Content-Type` approprié. Les ID de document proviennent du tableau `documents` dans la réponse de [Obtenir les résultats de laboratoire](https://docs.anivahealth.com/fr/api/appointments/get-results.md).

Nécessite le scope `results_view`.

> [!NOTE]
>
> L'accès est vérifié par rapport au profil propriétaire du document. Un document que tu as importé avec [Importer un document](https://docs.anivahealth.com/fr/api/documents/upload-document.md) est vérifié par rapport au groupe de profils dans lequel il a été importé.

## Requête

### Paramètres de chemin

**id** `string` *required*

ID du fichier (UUID) issu du tableau `documents` dans la réponse des résultats du rendez-vous.

## Réponse

En cas de succès, l'API renvoie `200 OK` avec les octets du fichier et quatre en-têtes. Chaque en-tête correspond à un champ du tableau `documents` :

| En-tête | Champ | Exemple |
| - | - | - |
| `Content-Type` | `content_type` | `application/pdf` |
| `Content-Disposition` | `file_name` | `attachment; filename="20260405 - Quade Befund - 7642001234.pdf"` |
| `ETag` | `etag` (entre guillemets) | `"56104b36f860cfd5b41efc716fdf7b6f"` |
| `Original-File-Name` | `original_file_name` | `7642001234_B0012_FA_E.pdf` |

`Original-File-Name` est encodé en UTF-8 avec encodage pourcentage, car un en-tête ne peut pas contenir tous les caractères possibles d'un nom de fichier importé. Décode-le avec `decodeURIComponent` ou un équivalent.

`ETag` et `If-None-Match` sont les en-têtes HTTP standard de mise en cache (RFC 9110). Envoie l'`etag` que tu as dans `If-None-Match` pour éviter de retélécharger un fichier inchangé. L'API répond alors `304 Not Modified` sans corps.

## Réponses d'erreur

| Statut | Description |
| - | - |
| `304` | Non modifié — l'etag `If-None-Match` correspond toujours au fichier. Sans corps. |
| `400` | Format d'ID invalide — la valeur fournie n'est pas un UUID valide. |
| `403` | Accès refusé — ta clé API n'a pas accès à cette opération ou le document est hors de ton contexte d'accès. |
| `404` | Document introuvable. |
| `500` | Erreur interne du serveur. |

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