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

# Introducción

> Vista general de la API para partners de Aniva, una API REST para análisis de sangre en farmacias y consultas, kits de prueba en casa y resultados de laboratorio.

La API de socios de Aniva es una API REST que permite a los socios sanitarios gestionar perfiles de pacientes, programar citas de extracción de sangre en ubicaciones de análisis y activar los flujos de órdenes de laboratorio. Interactúas con la API por HTTPS con tu clave API de socio.

## Qué puedes hacer

* **Gestión de perfiles** — Crear, consultar y actualizar perfiles demográficos de pacientes.
* **Programación de citas** — Reservar citas de extracción de sangre en las ubicaciones de análisis de Aniva.
* **Gestión de paneles** — Añadir o quitar paneles de análisis de laboratorio en una cita existente.
* **Biomarcadores individuales** — Vincular o desvincular biomarcadores individuales en una cita sin elegir un panel.
* **Pedidos de kits de prueba en casa** — Enviar un kit de prueba en casa por correo a un paciente, seguir sus paquetes e informar cuándo se recogió la muestra.
* **Catálogo de paneles** — Consultar los paneles disponibles con `GET /api/v1/panels` para obtener los ID de los paneles y los biomarcadores que incluye cada uno.
* **Catálogo de biomarcadores** — Consultar los biomarcadores que puedes pedir en una ubicación o en un kit de prueba en casa con `GET /api/v1/biomarkers` para obtener sus ID.
* **Confirmación de extracción de sangre** — Enviar el código o los códigos de laboratorio tras una extracción de sangre para activar el flujo de órdenes de laboratorio.
* **Resultados de laboratorio** — Obtener resultados clínicos y genéticos y descargar informes de laboratorio en PDF.
* **Búsqueda de ubicaciones** — Listar las ubicaciones de análisis disponibles para mostrárselas a los pacientes.
* **Logística de envíos** — Crear, seguir, modificar y cancelar pedidos de envío por mensajería.
* **Webhooks** — Recibir una llamada HTTPS cuando cambia una cita, un pedido de kit de prueba en casa, sus resultados, una ubicación, un perfil o un envío. Consulta [Webhooks](https://docs.anivahealth.com/es/concepts/webhooks.md).

## Explora la documentación

> [card] [Autenticación](https://docs.anivahealth.com/es/authentication.md)
>
> Autentica las solicitudes con tu clave API de socio.

> [card] [Inicio rápido](https://docs.anivahealth.com/es/quickstart.md)
>
> Haz tu primera llamada a la API en minutos con ejemplos paso a paso.

> [card] [Perfiles](https://docs.anivahealth.com/es/concepts/profiles.md)
>
> Descubre cómo funcionan los perfiles de pacientes y qué datos almacenan.

> [card] [Citas](https://docs.anivahealth.com/es/concepts/appointments.md)
>
> Entiende el ciclo de vida de una cita, desde la programación hasta la confirmación.

> [card] [Pedidos de kits de prueba en casa](https://docs.anivahealth.com/es/concepts/home-kit-orders.md)
>
> Envía un kit de prueba al domicilio de un paciente y síguelo hasta que la muestra llegue al laboratorio.

## Versionado de la API

La versión actual de la API es **v1**. Todos los endpoints llevan el prefijo `/api/v1/`. La URL base es `https://anivahealth.com`.

```text theme={null}
https://anivahealth.com/api/v1/
```

Los cambios incompatibles se introducirán bajo un nuevo prefijo de versión. La API v1 seguirá disponible y cualquier retirada se avisará con antelación.

## Fechas y zonas horarias

Todos los instantes transmitidos están en **UTC ISO 8601** (sufijo `Z`). Los campos solo de calendario usan **componentes de reloj
local** (`YYYY-MM-DD`, `HH:MM`).

| Categoría | Formato | Uso |
| - | - | - |
| **Instante** | ISO 8601 en UTC (sufijo `Z`, p. ej. `2026-04-15T08:30:00Z`) | Todas las fechas y horas de salida — `scheduled_at` de la cita, `slots[]` de disponibilidad, `pickup.from` / `pickup.till` del envío, `created_at`, `updated_at`, `added_at`. Muéstralo en cualquier zona horaria local en el cliente. |
| **Evento de proveedor** | ISO 8601 con el desplazamiento del proveedor externo (transmitido tal cual) | Solo `status_updates[].time` del envío — el desplazamiento refleja lo que comunicó la empresa de mensajería. |
| **Reloj local** | `YYYY-MM-DD` para fechas, `HH:MM` para horas — sin desplazamiento | Valores solo de calendario o de hora del día — `date_of_birth`, `tested_at` de los resultados, `start_date` / `end_date` de disponibilidad, `pickup_date` / `pickup_time_from` / `pickup_time_till` del envío, `open_hours` de la ubicación. |

Notas específicas:

* **Las entradas que aceptan una fecha y hora** (p. ej. `scheduled_at` en `POST` / `PATCH /api/v1/appointments`)
  **deben incluir un indicador de zona horaria**, ya sea `Z` o un desplazamiento explícito como `+02:00`. Las fechas y horas
  sin zona horaria se rechazan con `400`. Ambas formas codifican el mismo instante; la respuesta siempre
  devuelve `scheduled_at` en UTC `Z`. Usa el campo `timezone` de la ubicación (o cualquier otro identificador
  IANA) para formatear el instante en hora local al mostrarlo.
* **Las entradas de reloj local** se interpretan en la zona horaria del recurso al que apuntan: las fechas
  de disponibilidad usan el parámetro de consulta `timezone` (por defecto, la zona horaria de la ubicación);
  `pickup_date` / `pickup_time_*` del envío se interpretan en la zona horaria de la ubicación de origen.
* **Los campos de respuesta solo de fecha** (p. ej. `tested_at`, `availability[].date` de disponibilidad) son
  fechas de calendario sin zona horaria.

## Obtener acceso

Aniva emite las claves API por socio.

> [!NOTE]
>
> Contacta con Aniva para recibir tu clave API de socio.


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