Reservar análisis de sangre desde tu propio producto

Una sola clave API te da 45 endpoints, desde la reserva hasta los resultados de laboratorio

La API para socios de Aniva reserva una extracción de sangre en más de 25 centros de Alemania, añade paneles a esa cita y devuelve resultados clínicos y genéticos en JSON. Cada solicitud necesita una cabecera y la URL base es la misma en todos los entornos.

Cuándo usar Aniva

Usa Aniva cuando tus clientes necesiten reservar un análisis de sangre
Usa los endpoints de cita para una extracción de sangre en clínica y los endpoints de kit de prueba en casa para un kit por correo.
Usa los endpoints de resultados para las filas clínicas, las filas genéticas y el informe en PDF.
Usa los endpoints del catálogo para leer los biomarcadores, paneles y unidades que vende Aniva.
Usa las rutas documentadas en https://anivahealth.com/api/v1/ y no inventes endpoints.
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"
  }'
El flujo básico son cuatro peticiones
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

Hoy hay 45 endpoints documentados y activos

1

La autenticación solo necesita una cabecera de solicitud

v1

Todas las rutas empiezan con el prefijo v1

25+

Los centros en Alemania pueden hacer la extracción de sangre

Cuatro peticiones crean una integración funcional

Cuatro solicitudes van desde la reserva hasta los resultados de laboratorio

Cada solicitud devuelve el ID que necesita la siguiente, así que una integración básica son cuatro solicitudes antes de añadir paneles, cambios de cita o mensajería.

Paso 01 · GET /locations

Listas las ubicaciones en las que tu clave puede reservar

La respuesta te da cada dirección, el horario de apertura y la zona horaria, para que un cliente solo vea franjas horarias que existen.

Pruebas
Paso 02 · POST /profiles

Creas un perfil para el cliente

Un perfil necesita un nombre, un código de sexo, una fecha de nacimiento y tu profile_group, que acepta un UUID o tu propio slug.

Pruebas
Paso 03 · POST /appointments

Reservas la cita en la franja que elijas

La reserva necesita el ID del perfil, el ID de la ubicación y una fecha y hora en formato ISO 8601 con su desplazamiento horario o el sufijo Z.

Pruebas
Paso 04 · POST /appointments/{id}/confirm

Confirmas la extracción con el código de barras del kit

Esta solicitud inicia el pedido de laboratorio y bloquea la cita, así que modifica todos los paneles antes de enviarla.

Pruebas
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"
  }'
Capacidad

Cada grupo de recursos es una colección REST

Puedes pedir una extracción de sangre en una clínica o un kit de prueba en casa por correo. Ambos llegan en el mismo formato, así que solo escribes una vez el código que lee los resultados.

Perfiles · 4 endpoints

Un perfil es la persona a la que haces el análisis

Buscas un perfil por correo electrónico, lo creas en tu grupo de perfiles y actualizas los datos demográficos más adelante.

Pruebas
GET /profiles
PATCH /profiles/{id}
Citas · 15 endpoints

Una cita incluye los paneles y la extracción de sangre

Quince endpoints cubren la reserva y cualquier cambio posterior, incluidos los paneles, las vistas previas de los recipientes y la confirmación.

Pruebas
POST /appointments
GET /appointments/{id}/results
Pedidos de kits de prueba en casa · 10 endpoints

Los pedidos de kit de prueba en casa son la versión por correo

Diez endpoints solicitan un kit de prueba en casa para un perfil, cambian sus paneles y devuelven la misma estructura de resultados.

Pruebas
Crear un pedido de kit
Obtener resultados
Ubicaciones · 2 endpoints

Las ubicaciones te indican dónde se hace una extracción de sangre

Consultas las ubicaciones en las que tu clave puede reservar y luego pides a una de ellas los inicios de franja disponibles.

Pruebas
GET /locations
GET /locations/{id}/availability
Documentos · 1 endpoint

Los resultados llegan en filas clínicas y genéticas

Cada tipo de pedido tiene su propia llamada de resultados, y el informe en PDF se descarga por separado mediante el ID de archivo.

Pruebas
GET /appointments/{id}/results
GET /documents/{id}
Envíos · 8 endpoints

Un mensajero lleva la muestra al laboratorio

Creas un pedido de mensajería con una franja de recogida en día laborable, luego asocias las citas y consultas sus actualizaciones de estado.

Pruebas
POST /shipments
Adjuntar citas
Catálogos · 4 endpoints

Los catálogos enumeran los biomarcadores que puedes solicitar

Los catálogos de biomarcadores, paneles y unidades están paginados, y puedes filtrar los biomarcadores por ubicación de la prueba.

Pruebas
GET /biomarkers
GET /panels
Salud · 1 endpoint

Un endpoint de disponibilidad no necesita clave API

La sonda de preparación no necesita clave API, así que tu monitor de disponibilidad puede consultarla de forma programada.

Pruebas
Comprobación pública de disponibilidad
Tu trabajo termina con la confirmación del código de barras

El proceso de laboratorio empieza cuando confirmas la extracción de sangre

Nos envías el código de barras del kit y eso es lo último que necesitamos de ti. Después organizamos los recipientes, la mensajería y el laboratorio, así que tu código solo llama a dos endpoints hasta que el informe está listo.

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 punto relleno es la ruta que quieres.Un anillo es un estado que sigues gestionando.Las líneas naranjas son el pedido confirmado.
Un solo parser lee una extracción en clínica y un kit de prueba en casa

Cada resultado tiene dos intervalos de referencia y cuatro estados

Cada fila clínica incluye el intervalo informado por el laboratorio y el intervalo de Aniva con su franja óptima, para que puedas mostrar ambos sin mantener tu propia tabla de consulta.

Una fila muestra planificado antes de que el laboratorio la analice.
Una fila aparece como recibida en cuanto llegan un valor y una unidad.
Una fila muestra fault cuando el laboratorio ha cancelado la solicitud, y status_reason explica el motivo.
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" }]
}
La API usa tres formatos de tiempo

Las fechas y horas necesitan una zona horaria o la solicitud falla

Una fecha y hora sin zona horaria se rechaza con 400, que es el error que cometen la mayoría de las primeras integraciones.

Las marcas de tiempo siempre se devuelven en UTC, usando ISO 8601 con el sufijo Z.
Las entradas deben incluir un desplazamiento horario explícito, por lo que una reserva acepta 2026-05-15T12:30:00+02:00.
Las actualizaciones de envío conservan el desfase indicado por el proveedor logístico.
Los campos de calendario solo representan hora local, como una fecha de nacimiento.
Aniva emite y rota cada clave de socio

Cada solicitud necesita tu clave API de colaborador

La autenticación usa la cabecera x-api-key en cada llamada, y una clave ausente o rotada devuelve 403 con un breve error JSON.

Tu clave decide qué ubicaciones, citas y envíos puedes ver.
Nunca expongas tu clave de API en el código del lado del cliente ni en repositorios públicos.
Una sonda pública no necesita clave API

Puedes ver cada servicio en la página de estado

La página de estado muestra la situación actual y un historial de 90 días de cada servicio, y los mismos datos están disponibles en formato JSON para tu propia monitorización.

Las claves de socio las emite nuestro equipo

Pedirnos hoy una clave de socio

Dinos en qué mercados vendes y qué paneles necesitas, y te enviaremos una clave con los permisos adecuados.

También puedes descargar el archivo OpenAPI

Esta página es un prototipo de diseño. Todos los endpoints y payloads que aparecen provienen de docs.anivahealth.com, y el diagrama del pipeline es ilustrativo.

Las copias legibles por máquina de la documentación están en docs.anivahealth.com/llms.txt y docs.anivahealth.com/llms-full.txt.