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

# Importer un document

> Importer un rapport de laboratoire ou tout autre document dans un profil et, en option, en extraire les valeurs de laboratoire

Importe un fichier sur un profil. Envoie-le en `multipart/form-data`. Sans `extract_results`, Aniva se
contente de stocker le fichier. Avec `extract_results: true`, Aniva extrait aussi les valeurs de laboratoire du fichier.

Tu n'as pas à indiquer le type de compte rendu du fichier. Aniva décide. Un fichier sans résultats de laboratoire, comme
un courrier médical, se termine en `stored` et ne constitue pas une erreur.

Consulte les valeurs avec [Obtenir les résultats d'un document](https://docs.anivahealth.com/fr/api/documents/get-document-results.md). Tu n'as pas besoin de
faire du polling : abonne-toi aux [webhooks](https://docs.anivahealth.com/fr/concepts/webhooks.md) `document.results.*`.

Nécessite le scope `documents_upload` sur un groupe de profils du profil. `extract_results: true`
nécessite aussi le scope `documents_extract_results` sur le même groupe. Demande à Aniva de les ajouter. Le
document appartient à ce groupe : les clés disposant de `results_view` sur ce groupe peuvent lire le document et ses résultats.

Envoie un en-tête `Idempotency-Key` facultatif pour pouvoir relancer l'import en toute sécurité. Voir
[Idempotence](https://docs.anivahealth.com/fr/concepts/idempotency.md).

## Ce que fait l'extraction

Avec `extract_results: true` :

1. Aniva envoie le fichier à ses sous-traitants OCR et IA pour lire les valeurs.
2. Les valeurs apparaissent dans l'app Aniva du membre, comme tout autre résultat.
3. Chaque valeur porte `origin: partner_upload` et le même `status` que tout autre résultat. Une valeur
   dont la vérification automatique d'Aniva doute a le statut `likely_wrong`.

Sans elle, le fichier n'est envoyé à aucun service externe si tu envoies aussi `document_date`.

> [accordion] Précision et protection des données
>
> * La lecture automatique peut mal lire une valeur, une unité ou une date. Le fichier d'origine reste la source de
>   vérité. Vérifie une valeur sur ce fichier avant de l'utiliser pour une décision médicale. Les valeurs extraites ne
>   sont pas un diagnostic.
> * Les sous-traitants sont Mistral AI (OCR, UE) et Google Cloud Vertex AI, accessible via
>   Vercel AI Gateway (extraction, peut traiter des données hors UE). Ils traitent le fichier uniquement pour le lire.
> * Tu as besoin d'une base légale pour importer les données de santé d'un membre, normalement son
>   consentement explicite. Tu en es responsable.

## Requête

### Champs du formulaire

**file** `file` *required*

Le fichier. PDF, DOC, DOCX, PNG ou JPEG, 4 MB maximum.

**profile\_id** `string` *required*

UUID du profil auquel le document appartient.

**extract\_results** `boolean` (default: false)

`true` pour lire les valeurs de laboratoire dans le fichier. Envoie `true` ou `false`.

**document\_date** `string`

La date du prélèvement au format `YYYY-MM-DD`, si tu la connais. Sans elle, Aniva lit la date dans le
fichier.

## Réponse

L'API renvoie `201 Created` lorsqu'elle a uniquement stocké le fichier, et `202 Accepted` lorsque l'extraction est lancée.

**id** `string` *required*

Identifiant du document (UUID). Utilise-le avec [Obtenir les résultats du document](https://docs.anivahealth.com/fr/api/documents/get-document-results.md) et
[Télécharger le document](https://docs.anivahealth.com/fr/api/documents/download-document.md).

**status** `string` *required*

`processing` pendant qu'Aniva extrait les valeurs, ou `stored` lorsque le fichier est uniquement stocké.

**profile\_id** `string` *required*

Le profil auquel le document appartient.

**document\_date** `string`

La date du prélèvement que tu as envoyée, ou celle qu'Aniva a lue dans un fichier stocké. Peut être `null`.

**results\_url** `string` *required*

L'URL [Obtenir les résultats du document](https://docs.anivahealth.com/fr/api/documents/get-document-results.md) de ce document.

**file\_name** `string` *required*

Nom du fichier pour l'affichage, le même que celui envoyé par [Télécharger le document](https://docs.anivahealth.com/fr/api/documents/download-document.md).

**original\_file\_name** `string` *required*

Le nom du fichier que tu as importé.

**origin** `string` *required*

Toujours `partner_upload`.

**content\_type** `string` *required*

Type de média du fichier, par ex. `application/pdf`.

**etag** `string`

Version du contenu du fichier. Peut être `null`.

**size\_bytes** `integer`

Taille du fichier en octets. Peut être `null`.

**lab\_code** `string`

Toujours `null` pour un document importé.

## Réponses d'erreur

| Statut | Description |
| - | - |
| `400` | Un champ du formulaire n'est pas valide, ou le corps n'est pas au format `multipart/form-data`. |
| `403` | Il manque un scope à ta clé API, le profil n'est pas dans ton contexte d'accès, ou tu as envoyé `extract_results: true` sans `documents_extract_results`. |
| `404` | Profil introuvable. |
| `409` | `duplicate_document` : le même fichier est déjà sur ce profil. `document_id` l'indique, ou vaut `null` si tu ne peux pas le lire. Aussi envoyé en cas de conflit d'`Idempotency-Key`. |
| `413` | `file_too_large` : le fichier dépasse 4 MB. |
| `415` | `unsupported_media_type` : le fichier n'est pas un PDF, DOC, DOCX, PNG ou JPEG. Le nom du fichier doit se terminer par `.pdf`, `.doc`, `.docx`, `.png`, `.jpg` ou `.jpeg`. |
| `500` | Erreur interne du serveur. `extraction_not_started` : le fichier est stocké sous `document_id`, mais l'extraction n'a pas pu démarrer. Contacte Aniva. |

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/documents \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Idempotency-Key: 5f0c2d9e-3b7a-4c1e-9f62-1d8a4e7b0c55' \
  --form 'file=@lab-report.pdf' \
  --form 'profile_id=b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e' \
  --form 'extract_results=true'
```

```json 202 theme={null}
{
  "id": "f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c",
  "status": "processing",
  "profile_id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
  "document_date": null,
  "results_url": "https://anivahealth.com/api/v1/documents/f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c/results",
  "file_name": "20261023 - lab-report.pdf",
  "original_file_name": "lab-report.pdf",
  "origin": "partner_upload",
  "content_type": "application/pdf",
  "etag": "56104b36f860cfd5b41efc716fdf7b6f",
  "size_bytes": 312480,
  "lab_code": null
}
```

```json 409 theme={null}
{
  "error": "duplicate_document",
  "message": "This file is already on this profile",
  "document_id": "f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c"
}
```


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