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

# Récupérer les résultats d'un document

> Lire le statut et les valeurs de laboratoire extraites d'un document que tu as importé

Consulte le statut et les valeurs de laboratoire d'un document que tu as importé avec
[Importer un document](https://docs.anivahealth.com/fr/api/documents/upload-document.md). La réponse a la même structure que
[Obtenir les résultats de laboratoire](https://docs.anivahealth.com/fr/api/appointments/get-results.md) pour un rendez-vous. Voir
[Résultats](https://docs.anivahealth.com/fr/concepts/results.md) pour chaque champ.

Seuls les documents importés dans un groupe de profils sur lequel ta clé peut lire les résultats répondent. Tout autre
document renvoie `404` : consulte ses résultats via le rendez-vous ou la commande de kit à domicile qui l'a produit.

Tu n'as pas besoin de faire du polling. Abonne-toi aux [webhooks](https://docs.anivahealth.com/fr/concepts/webhooks.md) `document.results.updated` ou
`document.results.completed`, puis appelle cet endpoint à la réception d'un événement.

Nécessite le scope `results_view` sur le groupe de profils dans lequel le document a été importé.

## Requête

### Paramètres de chemin

**id** `string` *required*

ID du document (UUID) issu de la réponse d'import.

### En-têtes

**If-None-Match** `string`

L'`ETag` d'une réponse précédente. Si rien n'a changé, l'API répond `304 Not Modified` sans
corps.

## Réponse

En cas de succès, l'API renvoie `200 OK` avec l'objet de résultats et un en-tête `ETag`.

**status** `string` *required*

L'une des valeurs suivantes :

* `in_progress` — Aniva extrait les valeurs.
* `completed` — l'extraction est terminée.
* `fault` — l'extraction a échoué.
* `stored` — le document ne contient aucune valeur : tu l'as importé sans `extract_results`, ou il ne
  contient pas de résultats de laboratoire. `stored` est définitif : aucun webhook `document.results.completed` ne suit.

**clinical\_results** `object[]` *required*

Les valeurs extraites. Chaque valeur porte `origin: partner_upload`. Un compte rendu avec plusieurs
dates de prélèvement attribue à chaque valeur son propre `tested_at`. Jamais `planned` : un import ne commande rien.

**genetic\_results** `object[]` *required*

Résultats génétiques. Vide aujourd'hui pour un document importé.

**documents** `object[]` *required*

Le document importé lui-même.

**submissions** `object[]` *required*

Une entrée pour l'import. `lab_code` vaut `null`.

## Réponses d'erreur

| Statut | Description |
| - | - |
| `304` | Non modifié — l'etag `If-None-Match` correspond toujours. Sans corps. |
| `400` | Format d'ID invalide. |
| `403` | Ta clé API ne dispose pas du scope `results_view`. |
| `404` | Aucun document importé dans l'un de tes groupes de profils ne porte cet ID. |
| `500` | Erreur interne du serveur. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/documents/f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c/results \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "status": "stored",
  "submissions": [{ "lab_code": null, "status": "completed" }],
  "clinical_results": [],
  "genetic_results": [],
  "documents": [
    {
      "id": "f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c",
      "file_name": "20261023 - Arztbrief.pdf",
      "original_file_name": "arztbrief.pdf",
      "origin": "partner_upload",
      "content_type": "application/pdf",
      "etag": "56104b36f860cfd5b41efc716fdf7b6f",
      "size_bytes": 182311,
      "lab_code": null
    }
  ]
}
```


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