Documents
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é
GET
/
api
/
v1
/
documents
/
{id}
/
results
curl --request GET \
--url https://anivahealth.com/api/v1/documents/f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c/results \
--header 'x-api-key: YOUR_API_KEY'
{
"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
}
]
}
Consulte le statut et les valeurs de laboratoire d’un document que tu as importé avec
Importer un document. La réponse a la même structure que
Obtenir les résultats de laboratoire pour un rendez-vous. Voir
Résultats 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 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
En-têtes
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 renvoie200 OK avec l’objet de résultats et un en-tête ETag.
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é sansextract_results, ou il ne contient pas de résultats de laboratoire.storedest définitif : aucun webhookdocument.results.completedne suit.
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.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. |
curl --request GET \
--url https://anivahealth.com/api/v1/documents/f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c/results \
--header 'x-api-key: YOUR_API_KEY'
{
"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
}
]
}
⌘I
curl --request GET \
--url https://anivahealth.com/api/v1/documents/f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c/results \
--header 'x-api-key: YOUR_API_KEY'
{
"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
}
]
}