Réserver des bilans sanguins directement depuis ton propre produit

Une clé API te donne accès à 45 endpoints, de la réservation aux résultats de laboratoire

L'Aniva Partner API réserve une prise de sang dans plus de 25 sites en Allemagne, ajoute des panels à ce rendez-vous et renvoie les résultats cliniques et génétiques en JSON. Chaque requête nécessite un seul en-tête et l'URL de base est la même dans chaque environnement.

Quand utiliser Aniva

Utilise Aniva quand tes clients ont besoin de réserver un bilan sanguin
Utilise les endpoints de rendez-vous pour une prise de sang en clinique et les endpoints de kit à domicile pour un kit par courrier.
Utilise les endpoints de résultats pour les lignes cliniques, les lignes génétiques et le rapport PDF.
Utilise les endpoints du catalogue pour lire les biomarqueurs, les panels et les unités que vend Aniva.
Utilise les chemins documentés sous https://anivahealth.com/api/v1/ et n’invente pas de points de terminaison.
POST /api/v1/appointments
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "scheduled_at": "2026-05-15T12:30:00+02:00"
  }'
Le flux de base tient en quatre requêtes
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

45 endpoints sont documentés et actifs aujourd'hui

1

L'authentification ne nécessite qu'un seul en-tête de requête

v1

Chaque chemin commence par le préfixe v1

25+

Les sites en Allemagne peuvent réaliser la prise de sang

Quatre requêtes pour bâtir une intégration fonctionnelle

Quatre requêtes mènent de la réservation aux résultats de laboratoire

Chaque requête renvoie l'identifiant dont la suivante a besoin, donc une intégration de base représente quatre requêtes avant d'ajouter les panels, les reports ou les coursiers.

Étape 01 · GET /locations

Tu listes les sites que ta clé peut réserver

La réponse te renvoie chaque adresse, les horaires d'ouverture et le fuseau horaire, afin qu'un client ne voie que des créneaux qui existent.

Tests
Étape 02 · POST /profiles

Tu crées un profil pour le client

Un profil nécessite un nom, un code de sexe, une date de naissance et ton profile_group, qui accepte un UUID ou ton propre slug.

Tests
Étape 03 · POST /appointments

Tu réserves le rendez-vous sur le créneau de ton choix

La réservation nécessite l'ID de profil, l'ID de lieu et une date-heure ISO 8601 avec son décalage horaire ou le suffixe Z.

Tests
Étape 04 · POST /appointments/{id}/confirm

Tu confirmes la prise de sang avec le code-barres du kit

Cette requête lance la commande au laboratoire et verrouille le rendez-vous, alors modifie chaque panel avant de l'envoyer.

Tests
POST /api/v1/appointments
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "scheduled_at": "2026-05-15T12:30:00+02:00"
  }'
Capacité

Chaque groupe de ressources est une collection REST

Tu peux commander une prise de sang en clinique ou un kit à domicile par courrier. Les deux reviennent au même format, donc tu n'écris qu'une seule fois le code qui lit les résultats.

Profils · 4 endpoints

Un profil correspond à la personne que tu testes

Tu recherches un profil par e-mail, le crées dans ton groupe de profils et mets à jour les données démographiques plus tard.

Tests
GET /profiles
PATCH /profiles/{id}
Rendez-vous · 15 endpoints

Un rendez-vous comprend les panels et la prise de sang

Quinze points d'accès couvrent la réservation et chaque modification ultérieure, y compris les panels, les aperçus des contenants et la confirmation.

Tests
POST /appointments
GET /appointments/{id}/results
Commandes de kits à domicile · 10 endpoints

Les commandes de kit à domicile sont la version par courrier

Dix endpoints demandent un kit à domicile pour un profil, modifient ses panels et renvoient la même structure de résultats.

Tests
Créer une commande de kit
Obtenir les résultats
Lieux · 2 points d’accès

Les lieux t'indiquent où se déroule la prise de sang

Tu lis les lieux que ta clé peut réserver, puis tu demandes à l'un d'eux les débuts de créneaux réservables.

Tests
GET /locations
GET /locations/{id}/availability
Documents · 1 point de terminaison

Les résultats reviennent sous forme de lignes cliniques et génétiques

Chaque type de commande a son propre appel de résultats, et le rapport PDF est un téléchargement distinct par ID de fichier.

Tests
GET /appointments/{id}/results
GET /documents/{id}
Expéditions · 8 endpoints

Un coursier apporte l'échantillon au laboratoire

Tu crées une commande de coursier avec un créneau de collecte en semaine, puis tu y associes des rendez-vous et tu suis les mises à jour de statut.

Tests
POST /shipments
Associer des rendez-vous
Catalogues · 4 endpoints

Les catalogues listent les biomarqueurs que tu peux commander

Les catalogues de biomarqueurs, de panels et d’unités sont paginés, et tu peux filtrer les biomarqueurs par lieu de test.

Tests
GET /biomarkers
GET /panels
Santé · 1 endpoint

Un endpoint de disponibilité ne nécessite pas de clé API

La sonde de disponibilité n'a pas besoin de clé API, ton outil de monitoring peut donc l'appeler à intervalles réguliers.

Tests
Sonde de disponibilité publique
Ton travail s'arrête à la confirmation du code-barres

Le processus de laboratoire démarre quand tu confirmes la prise de sang

Tu nous envoies le code-barres du kit, et c’est tout ce dont nous avons besoin de ta part. Nous organisons ensuite les contenants, le coursier et le laboratoire, de sorte que ton code n’appelle que deux endpoints jusqu’à ce que le compte rendu soit prêt.

The Aniva lab pipeline from confirmation to results Confirming the draw is followed by container selection, courier collection and laboratory analysis, and each biomarker row then reads as planned, received or fault. POST /appointments/{id}/confirmYou confirm the draw GET /appointments/{id}/previewContainers are known POST /shipmentsA courier collects it Aniva laboratory networkThe laboratory analyses planned received fault GET /appointments/{id}/results
Un point plein est le parcours que tu veux.Un anneau est un état que tu gères encore.Les lignes orange indiquent la commande confirmée.
Un seul parseur lit une prise de sang en clinique et un kit à domicile

Chaque résultat a deux intervalles de référence et quatre statuts

Chaque ligne clinique contient l'intervalle transmis par le laboratoire et l'intervalle Aniva avec sa fenêtre optimale, afin que tu puisses afficher les deux sans maintenir ta propre table de correspondance.

Une ligne indique planifié avant que le laboratoire ne l’analyse.
Une ligne affiche reçu dès qu'une valeur et une unité reviennent.
Une ligne indique fault lorsque le laboratoire a annulé la demande, et status_reason l'explique.
GET /api/v1/appointments/{id}/results
{
  "status": "in_progress",
  "clinical_results": [{
    "status": "received",
    "biomarker_name": "Vitamin D",
    "value": 38.5, "unit": "ng/mL",
    "reference_range_lab": { "normal_min": 30, "normal_max": 100 },
    "reference_range_aniva": { "optimal_min": 40, "optimal_max": 60 },
    "tested_at": "2026-04-05"
  }],
  "documents": [{ "file_name": "lab-report-2026-04-05.pdf" }]
}
L'API utilise trois formats temporels

Les dates et heures doivent inclure un fuseau horaire, sinon la requête échoue

Un datetime naïf est rejeté avec le code 400, ce qui est l'erreur que font la plupart des premières intégrations.

Les horodatages sont toujours renvoyés en UTC, au format ISO 8601 avec le suffixe Z.
Les entrées doivent inclure un décalage horaire explicite, ainsi une réservation accepte 2026-05-15T12:30:00+02:00.
Les mises à jour d'expédition conservent le décalage indiqué par le prestataire logistique.
Les champs de calendrier n’utilisent que l’heure locale, comme une date de naissance.
Aniva émet et renouvelle chaque clé partenaire

Chaque requête nécessite ta clé API partenaire

L'authentification utilise l'en-tête x-api-key à chaque appel, et une clé manquante ou remplacée renvoie 403 avec une courte erreur JSON.

Ta clé détermine les lieux, les rendez-vous et les envois que tu peux voir.
N'expose jamais ta clé API dans du code côté client ou dans des dépôts publics.
Une sonde publique n'a pas besoin de clé API

Tu peux suivre chaque service sur la page de statut

La page de statut affiche l'état actuel et 90 jours d'historique pour chaque service, et ces mêmes données sont disponibles au format JSON pour ton propre outil de monitoring.

Les clés partenaires sont délivrées par notre équipe

Nous demander une clé partenaire dès aujourd'hui

Dis-nous sur quels marchés tu vends et de quels panels tu as besoin, et nous t'enverrons une clé avec les bonnes autorisations.

Tu peux aussi télécharger le fichier OpenAPI

Cette page est une maquette. Chaque endpoint et chaque payload qui y figure provient de docs.anivahealth.com, et le schéma du pipeline est illustratif.

Des copies de la documentation lisibles par machine sont disponibles sur docs.anivahealth.com/llms.txt et docs.anivahealth.com/llms-full.txt.