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

# Pedidos de kits de prueba en casa

> Cómo funcionan los pedidos de kits de prueba en casa en la API de Aniva: pedido de un kit por correo, envío, devolución de la muestra y resultados de laboratorio.

Un **pedido de kit de prueba en casa** envía por correo al paciente un kit de pruebas para hacer por su cuenta. Aniva envía el kit, el paciente recoge la muestra en casa y la devuelve por correo. Esto se diferencia de una [cita](https://docs.anivahealth.com/es/concepts/appointments.md), que es una extracción de sangre venosa realizada por un profesional sanitario en un centro de pruebas físico.

> [!NOTE]
>
> Los endpoints de pedidos de kit de prueba en casa requieren el scope `home_kit_orders_view` (lectura) o
> `home_kit_orders_manage` (escritura). [Activar](https://docs.anivahealth.com/es/api/home-kit-orders/activate-home-kit.md) también acepta el
> scope más restringido `home_kit_orders_activate`. [Obtener resultados](https://docs.anivahealth.com/es/api/home-kit-orders/get-results.md) y
> [Enviar resultados por correo](https://docs.anivahealth.com/es/api/home-kit-orders/email-results.md) requieren además `results_view`: los
> resultados de laboratorio y los documentos siempre están protegidos por este scope.

## Campos

**id** `string` *required*

UUID generado automáticamente por Aniva. Úsalo para actualizar el pedido, cambiar su panel, activarlo,
cancelarlo y obtener resultados.

**profile\_id** `string` *required*

El UUID del perfil al que pertenece este pedido de kit de prueba en casa.

**status** `string` *required*

Estado actual del ciclo de vida. Puede ser `pending`, `dispatched`, `activated` o `cancelled`. Consulta
[Ciclo de vida](#ciclo-de-vida) más abajo. El estado detallado de los resultados de laboratorio (`in_progress` o `completed`)
se obtiene en [Obtener resultados](https://docs.anivahealth.com/es/api/home-kit-orders/get-results.md).

**delivery\_address** `object` *required*

La dirección a la que se envía el kit por correo, con dos formatos posibles: `{location_id}`, que referencia un
centro de pruebas conocido, o los campos de dirección directa (`name`, `street`, `city`, `postal_code`,
`country_code`; `company_name` / `house_number` / `address_line_2` / `state` / `phone` / `email`
opcionales, con los mismos nombres que la API de ubicaciones). Indica exactamente uno: una referencia de ubicación
o una dirección directa, nunca ambos.

**dirección de entrega**

> [tab] Referencia de ubicación
>
> **location\_id** `string` *required*
>
> UUID del centro de pruebas al que se envía el kit.

> [tab] Dirección directa
>
> **name** `string` *required*
>
> Nombre del destinatario, la empresa o el centro.
>
> **company\_name** `string`
>
> Empresa que recibe el paquete para el destinatario: un `c/o` o un departamento.
>
> **street** `string` *required*
>
> Nombre de la calle, sin el número (p. ej., `Wilhelmstraße`).
>
> **house\_number** `string`
>
> Número de calle (p. ej., `118` o `12a`).
>
> **address\_line\_2** `string`
>
> Edificio, portal o piso.
>
> **city** `string` *required*
>
> **state** `string`
>
> Estado o provincia. Opcional.
>
> **postal\_code** `string` *required*
>
> **country\_code** `string` *required*
>
> Código ISO 3166-1 alfa-2 (dos letras, p. ej., `DE`).
>
> **phone** `string`
>
> Número de teléfono del destinatario. El transportista lo recibe para avisarle sobre el paquete.
>
> **email** `string`
>
> Correo electrónico del destinatario. El transportista lo recibe para avisarle sobre el paquete.

> [!NOTE]
>
> **Packstation o Postfiliale (solo en Alemania):** define `street` como `Packstation` o `Postfiliale`,
> `house_number` con el número de estación de tres dígitos y `address_line_2` con el DHL Postnummer
> del destinatario (6–10 dígitos, se admiten espacios). Sin el Postnummer, no se puede tramitar el envío del paquete.
> No se admite Postfach.

**created\_at** `string` *required*

Marca de tiempo ISO 8601 de cuándo se creó el pedido de kit de prueba en casa.

**updated\_at** `string`

Marca de tiempo ISO 8601 de la actualización más reciente. Nulo si el pedido de kit de prueba en casa nunca se ha actualizado.

**profile** `object`

El objeto completo del perfil del paciente, incluido en cada respuesta de pedido de kit de prueba en casa.

**propiedades**

**id** `string`

UUID del perfil asociado.

**handle** `string`

Identificador o nombre de usuario del perfil. Puede ser `null`.

**first\_name** `string`

Nombre del paciente. Puede ser `null`.

**last\_name** `string`

Apellido del paciente. Puede ser `null`.

**email** `string`

Dirección de correo electrónico del paciente. Puede ser `null`.

**phone** `string`

Número de teléfono en formato E.164. Puede ser `null`.

**sex** `integer`

Sexo biológico según ISO/IEC 5218. Puede ser `null`.

**date\_of\_birth** `string`

Fecha de nacimiento en formato `YYYY-MM-DD`. Puede ser `null`.

**height** `number`

Altura en centímetros. Puede ser `null`.

**weight** `number`

Peso en kilogramos. Puede ser `null`.

**language** `string`

Idioma preferido: uno de los 32 códigos de [Crear perfil](https://docs.anivahealth.com/es/api/profiles/create-profile.md).

**transactional\_emails\_enabled** `boolean`

Indica si este perfil recibe correos electrónicos transaccionales (automáticos). Puede ser `null`.

**created\_at** `string`

Marca de tiempo ISO 8601 de creación del perfil.

**updated\_at** `string`

Marca de tiempo ISO 8601 de la última actualización del perfil. Puede ser `null`.

**panels** `object[]`

El panel asociado al pedido de kit de prueba en casa: siempre contiene exactamente una entrada `{ panel_id, added_at }`,
porque cada kit de prueba en casa corresponde 1:1 a un kit físico. Consulta `panel_id` en
[Listar paneles](https://docs.anivahealth.com/es/api/panels/list-panels.md).

**individual\_biomarkers** `object[]`

Biomarcadores asociados al pedido de kit de prueba en casa fuera de su panel. Cada entrada es
`{ biomarker_id, added_at }`. Consulta cada `biomarker_id` en
[Listar biomarcadores](https://docs.anivahealth.com/es/api/biomarkers/list-biomarkers.md) con `home_kit=true`. En un pedido normal son pruebas adicionales
a la carta sobre el panel; en un [kit de sustitución](#kits-de-reemplazo) son las que el laboratorio
vuelve a analizar.

**replaces\_home\_kit\_order\_id** `string`

El pedido de kit de prueba en casa al que sustituye, cuando se trata de un [kit de sustitución](#kits-de-reemplazo). `null` en
un pedido normal.

**replacement\_reason** `string`

Motivo por el que se envió la sustitución, en una frase. `null` en un pedido normal.

**results\_ready\_emails** `string[]`

Direcciones en minúsculas que reciben un correo cada una cuando todos los resultados de laboratorio son definitivos. Siempre presente;
vacío cuando está desactivado. Configúralo en [Crear](https://docs.anivahealth.com/es/api/home-kit-orders/create-home-kit.md) o
[Actualizar](https://docs.anivahealth.com/es/api/home-kit-orders/update-home-kit.md). Consulta
[Correos de resultados listos](https://docs.anivahealth.com/es/concepts/results.md#correos-de-resultados-listos).

**metadata** `object`

Tus propios pares clave/valor, devueltos tal cual y nunca interpretados por Aniva. Siempre presente
al leer: `{}` si no defines ninguno. Máximo 20 claves; las claves deben coincidir con `[A-Za-z0-9_-]` y tener como máximo 40
caracteres; los valores son cadenas, números o booleanos, con cadenas de hasta 500 caracteres; 16.384
bytes serializados en total. Las claves que empiezan por `aniva_` están reservadas. En
[Actualizar](https://docs.anivahealth.com/es/api/home-kit-orders/update-home-kit.md), los metadatos se **combinan**: las claves que omitas se conservan, una
clave enviada como `null` se elimina y `{}` lo borra todo. La validación es todo o nada. Nunca incluyas
datos personales ni clínicos en `metadata`: no se tratan como datos del paciente.

**lab\_code** `string`

El código de muestra de laboratorio. Un código, tres funciones: con el que se emiten los resultados de laboratorio, el que viene impreso
en el kit físico y el que el paciente lee en la caja como código de activación. Se asigna al
empaquetar el kit; es `null` mientras el pedido está en `pending`, salvo cuando Aniva reenvía un kit (consulta
[Ciclo de vida](#ciclo-de-vida)). Siempre de solo lectura. Encuentra el pedido de un kit físico
con `GET /api/v1/home-kit-orders?lab_code=…`.

**activated\_at** `string`

La marca de tiempo de recogida indicada mediante [Activar](https://docs.anivahealth.com/es/api/home-kit-orders/activate-home-kit.md): cuándo
recogió realmente el paciente su muestra, en formato UTC. `null` hasta que se activa el kit.
Esta es la hora de recogida que figura en el informe de laboratorio.

**shipments** `object[]`

Los paquetes vinculados a este pedido, del más antiguo al más reciente, cada uno con `{ id, added_at }`: el kit de
camino al paciente y, en los kits con seguimiento de devolución, la muestra de vuelta al
laboratorio, que aparecen en cuanto se imprimen las etiquetas. Vacío mientras el pedido está en
`pending`, salvo cuando Aniva reenvía un kit. Obtén los
paquetes completos en una sola llamada con `GET /api/v1/shipments?home_kit_order_id={id}`; consulta
[Envíos](https://docs.anivahealth.com/es/concepts/shipments.md).

## Ciclo de vida

Los pedidos de kit de prueba en casa exponen cuatro estados de ciclo de vida:

```
pending → dispatched → activated
   │          │
   │          ├──→ pending    (Aniva re-ships a lost kit)
   │          └──→ cancelled  (Aniva: the box came back undelivered)
   │
   └──→ cancelled
```

| Estado | Significado |
| - | - |
| `pending` | El pedido se ha creado, pero el kit aún no se ha empaquetado. Se puede [actualizar](https://docs.anivahealth.com/es/api/home-kit-orders/update-home-kit.md) (dirección, cambio de panel, metadatos) o [cancelar](https://docs.anivahealth.com/es/api/home-kit-orders/cancel-home-kit.md). |
| `dispatched` | El kit está empaquetado y etiquetado: va de camino al paciente (o ya está en sus manos). Su composición de panel y biomarcadores queda **bloqueada** y ya no puedes [cancelarlo](https://docs.anivahealth.com/es/api/home-kit-orders/cancel-home-kit.md). Aniva aún puede cambiar su estado: de vuelta a `pending` si un kit se pierde y Aniva envía uno nuevo, o a `cancelled` si la caja se devuelve sin entregar y no se vuelve a enviar. |
| `activated` | El paciente ha recogido su muestra y se ha notificado mediante [Activar](https://docs.anivahealth.com/es/api/home-kit-orders/activate-home-kit.md) con la marca de tiempo de la recogida. La orden de laboratorio se tramita con el `lab_code` del kit. Es un estado final, análogo a `blood_drawn` en una cita. |
| `cancelled` | El pedido de kit de prueba en casa se ha cancelado: por ti desde `pending`, o por Aniva desde `dispatched` si la caja volvió sin entregar. Es un estado final: no admite más transiciones y volver a cancelarlo no tiene efecto y devuelve el pedido. |

Cuando Aniva reenvía un kit perdido, el pedido vuelve a `pending`, pero conserva su `lab_code` y sus
paquetes anteriores en `shipments`. El nuevo kit lleva el mismo código. En la nueva caja se incluye
una etiqueta de devolución sin usar. Solo Aniva realiza estos dos cambios; la API no los ofrece. Cada cambio envía un
[webhook](https://docs.anivahealth.com/es/concepts/webhooks.md) `home_kit_order.pending` o `home_kit_order.cancelled`.

> [!NOTE]
>
> Los estados del pedido de kit de prueba en casa son deliberadamente generales. El progreso del envío hacia y desde el
> paciente se sigue en los [envíos](https://docs.anivahealth.com/es/concepts/shipments.md) del pedido: `dispatched` significa que el kit
> tiene etiqueta y código de laboratorio, no que se haya movido; el `status` del envío de ida indica si
> lo ha hecho. El procesamiento de los resultados de laboratorio se gestiona en las solicitudes de laboratorio. El estado de finalización de los resultados (`in_progress` frente a
> `completed`) se consulta mediante [Obtener resultados](https://docs.anivahealth.com/es/api/home-kit-orders/get-results.md): el campo
> `status` de nivel superior es `in_progress` hasta que se cierra cada solicitud, momento en el que pasa a `completed`, o a `fault` si
> todas terminaron sin informar resultados.

## Seguimiento de los paquetes

```
GET /api/v1/shipments?home_kit_order_id={id}
```

Lo que se devuelve depende del kit. Un kit de sangre aparece como dos envíos una vez que Aniva lo ha
empaquetado: el paquete de Aniva al paciente y el del
paciente al laboratorio (su `destination` es el laboratorio), emparejados mediante `paired_with`. El
paquete de devolución permanece en `pending` —con su número de seguimiento ya asignado— hasta que el paciente lo
envía. Un kit de microbioma intestinal aparece como un solo envío: el kit hacia el paciente. Su sobre de devolución es
prepagado y sin seguimiento, por lo que no se registra nada para la vuelta. `booked_by` indica quién generó la
etiqueta: `"aniva"` o `"external"`. Aquí solo se puede modificar un paquete de `"aniva"`, y únicamente sus
`notes` una vez impresa la etiqueta. Cada paquete incluye todas las `status_updates` del transportista,
incluido el `detail_code` de DHL en caso de desvío a una oficina de correos.

`home_kit_orders` en el envío solo incluye los pedidos de tu contexto de acceso. Consulta
[Acceso](https://docs.anivahealth.com/es/concepts/shipments.md#acceso).

> [!WARNING]
>
> La composición de un pedido de kit de prueba en casa solo se puede modificar mientras está en `pending`. Una vez que el pedido pasa a
> `dispatched` (o posterior: `activated`/`cancelled`), los cambios de panel y los endpoints `/biomarkers`
> devuelven `409 Conflict`: el kit físico se empaqueta según el panel seleccionado, por lo que su contenido queda
> fijado en cuanto sale hacia el paciente. Si necesitas cambiar las pruebas de un pedido que ya está
> bloqueado, ponte en contacto directamente con Aniva: suele ser posible y haremos el
> cambio por ti para mantener la coherencia del contenido del kit. Si el kit ya se ha utilizado y no ha podido
> ofrecer resultados, pide en su lugar un [kit de sustitución](#kits-de-reemplazo).

## Listar pedidos de kits de prueba en casa

Obtén todos los pedidos de kits de prueba en casa accesibles con tu clave de API:

```
GET /api/v1/home-kit-orders
```

De forma opcional, pasa `?profile_id={uuid}` para filtrar por un perfil concreto, o `?lab_code={code}` para
asociar un kit físico que tengas a mano con su pedido: el primer paso habitual de un flujo de activación.

## Crear un pedido de kit de prueba en casa

Solicita un pedido de kit de prueba en casa para un perfil de paciente:

```
POST /api/v1/home-kit-orders
```

Pasa el `profile_id`, una `delivery_address` y un único `panel_id`. El pedido se crea en estado `pending`.

Pasa una cabecera opcional `Idempotency-Key` para que un reintento no pida un segundo kit; consulta [Idempotencia](https://docs.anivahealth.com/es/concepts/idempotency.md).

Debe ser exactamente un panel, porque un kit de prueba en casa se corresponde 1:1 con un producto de kit físico: el panel es el kit. Solo se pueden pedir los paneles que Aniva haya configurado como kits de prueba en casa; cualquier otro panel se rechaza con `422`. Es obligatorio al crearlo porque el pedido entra de inmediato en la cola de empaquetado y puede empezar a prepararse al instante. Mientras el pedido esté en `pending`, puedes cambiar el panel mediante [Actualizar](https://docs.anivahealth.com/es/api/home-kit-orders/update-home-kit.md).

Para enviar un segundo kit en lugar de uno que no pudo ofrecer resultados, pasa `replaces_home_kit_order_id` en vez de elegir un panel; consulta [Kits de sustitución](#kits-de-reemplazo).

## Kits de reemplazo

A veces un kit no puede ofrecer resultados: el paciente no pudo llenar el tubo, la muestra llegó con demasiado poco material o el laboratorio no pudo analizar una parte. Pide una **sustitución**:

```
POST /api/v1/home-kit-orders
{
  "profile_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "delivery_address": { "...": "..." },
  "replaces_home_kit_order_id": "d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a",
  "replacement_reason": "Too little material, HbA1c could not be analysed",
  "biomarker_ids": [103]
}
```

Una sustitución es un **nuevo pedido con un nuevo código de laboratorio**, incluso cuando el primer kit nunca llegó a activarse: el laboratorio necesita una nueva solicitud y no se pueden distinguir dos muestras con el mismo código. Ambos pedidos siguen siendo legibles y quedan vinculados mediante `replaces_home_kit_order_id`.

**El pedido sustituido no se modifica.** Conserva su estado, su código de laboratorio y cualquier resultado ya registrado en él, de modo que si el paciente acaba enviando el primer kit, recibirá lo que el laboratorio pueda analizar.

**El panel se hereda.** Si omites `panel_id`, la sustitución lleva el panel del pedido al que sustituye: es lo que compró el paciente y el diseño que lleva la caja. Envía un panel distinto solo para sustituir un panel completo; enviar un panel y un subconjunto de marcadores a la vez se rechaza con `422`, ya que un subconjunto solo tiene sentido dentro del panel del que se seleccionó. El panel de una sustitución tampoco se puede cambiar después.

**Tú eliges qué se vuelve a analizar.** Envía `biomarker_ids` con los marcadores que fallaron y el laboratorio volverá a analizar solo esos, de modo que el kit se envía únicamente con los tubos necesarios. Omítelo para repetir el panel completo, que es la opción adecuada cuando no se analizó nada. Esto no requiere ningún scope adicional: repetir marcadores que el paciente ya pagó no es una selección a la carta. Esos marcadores no se pueden eliminar después, porque constituyen toda la solicitud.

> [!NOTE]
>
> Los marcadores se repiten por **grupos** del panel, no de uno en uno. Indicar un marcador de un grupo repite
> todo ese grupo, porque no se puede cursar una orden de laboratorio que informe más de lo solicitado.
> Por tanto, una sustitución para un solo marcador puede devolver más de un resultado y
> requerir más tubos de los que sugiere la lista de marcadores.

Solo puede haber una sustitución en curso por kit a la vez: mientras una sustitución esté en `pending` o `dispatched`, una segunda solicitud para el mismo pedido devuelve `409` indicándola. Los resultados llegan con el `lab_code` propio de la sustitución, a través de su propio [Obtener resultados](https://docs.anivahealth.com/es/api/home-kit-orders/get-results.md).

Una sustitución no es la forma de gestionar un paquete que nunca llegó. En ese caso, avisa a Aniva: se trata de un reenvío del mismo pedido con el mismo código de laboratorio, no de uno nuevo.

## Actualizar un pedido de kit de prueba en casa

Cambia la dirección de entrega, sustituye el panel, actualiza tus metadatos o reemplaza los correos de aviso de resultados disponibles:

```
PATCH /api/v1/home-kit-orders/{id}
```

Incluye solo los campos que quieras cambiar. `panel_id` **sustituye** el panel asociado: al haber exactamente un panel por kit, el cambio es la única operación de panel con sentido, por lo que no existen endpoints para añadir o eliminar paneles. La dirección y el panel solo se pueden modificar mientras el pedido está en `pending`; `metadata` se puede editar durante toda la vida del pedido. `results_ready_emails` se puede editar hasta que el pedido pase a `cancelled`.

## Cancelar un pedido de kit de prueba en casa

Cancela un pedido de kit de prueba en casa que ya no sea necesario:

```
DELETE /api/v1/home-kit-orders/{id}
```

Esto cambia el estado del pedido de kit de prueba en casa a `cancelled`. La respuesta devuelve el pedido cancelado.

Solo se puede cancelar un pedido en `pending`. A partir de `dispatched`, el kit ya está empaquetado y etiquetado —no existe retirada automática— y la llamada devuelve `409`. Si necesitas detener un kit que ya ha salido, ponte en contacto directamente con Aniva.

Cancelar un pedido en `pending` cuyo kit ya se haya solicitado al centro logístico también lo cancela allí, y la llamada solo tiene éxito si el centro logístico la acepta:

* `409` — el kit ya estaba empaquetado y etiquetado, así que ya no se puede retirar, aunque el pedido aún aparezca en `pending`.
* `502` — el centro logístico rechazó la cancelación (el error incluye el motivo) o no se pudo contactar con él. **No se ha modificado nada**: el pedido sigue activo y puedes volver a cancelarlo.

Una cancelación que devuelve error deja el pedido exactamente como estaba, así que un `200` es la única confirmación de que no se enviará ningún kit.

Cancelar un pedido que ya está en `cancelled` devuelve el mismo `200`, con independencia del estado desde el que se canceló.

## Activar un pedido de kit de prueba en casa

Cuando el paciente haya recogido su muestra, notifícalo:

```
POST /api/v1/home-kit-orders/{id}/activate
```

Pasa `activated_at`: el momento real en que el paciente recogió la muestra, como instante UTC. Esta es la hora de recogida que aparecerá en el informe de laboratorio, así que envía el momento real de la recogida, no tu hora de procesamiento. La activación es definitiva: el pedido pasa a `activated` y ya no se puede cancelar ni modificar. Es el equivalente para kits de prueba en casa de [Confirmar extracción de sangre](https://docs.anivahealth.com/es/api/appointments/confirm-blood-draw.md), sin código de barras: el código del kit se aplica al empaquetarlo, así que nunca necesitas conocerlo. Para entonces, el pedido debe tener su `lab_code`; un pedido sin él devuelve `409`.

La activación es también lo que cursa la orden de laboratorio: el panel del kit se solicita al laboratorio con su `lab_code`, de modo que la muestra devuelta queda esperada y los resultados se asocian a medida que el laboratorio los informa. Esto se ejecuta después de la respuesta, y cualquier incidencia en el laboratorio la gestiona Aniva en lugar de reflejarse en tu petición.

## Biomarcadores individuales

Puedes añadir biomarcadores individuales a un pedido de kit de prueba en casa como pruebas a la carta, fuera del panel. Esto resulta útil cuando quieres una selección a medida además del kit. Los biomarcadores añadidos aparecen en la respuesta del pedido como un array `individual_biomarkers` (al mismo nivel que `panels`).

Ambos endpoints de biomarcadores requieren el scope de capacidad `home_kit_orders_individual_biomarker_selection` además de `home_kit_orders_manage`: los kits de prueba en casa se piden por panel, así que los marcadores a la carta se activan por partner. Pregunta a Aniva si tu integración lo necesita.

Añade biomarcadores (idempotente: los biomarcadores ya asociados se conservan):

```
PATCH /api/v1/home-kit-orders/{id}/biomarkers
```

Eliminar biomarcadores (idempotente: un ID que no esté asociado se ignora):

```
DELETE /api/v1/home-kit-orders/{id}/biomarkers
```

Ambos endpoints aceptan un array `biomarker_ids`. Usa [Listar biomarcadores](https://docs.anivahealth.com/es/api/biomarkers/list-biomarkers.md) con `home_kit=true` para consultar los ID de biomarcadores. Los biomarcadores solo se pueden cambiar mientras el kit esté en `pending` (consulta [Ciclo de vida](#ciclo-de-vida)).

## Obtener resultados de laboratorio

Una vez que el laboratorio haya procesado la muestra devuelta, obtén los resultados clínicos y genéticos:

```
GET /api/v1/home-kit-orders/{id}/results
```

La respuesta incluye las pruebas planificadas (estado `planned`) junto con los resultados recibidos, para que puedas seguir qué queda pendiente. Los resultados se registran bajo el `lab_code` del pedido y llegan marcador a marcador a medida que el laboratorio los analiza, así que es normal recibir payloads parciales. El campo `status` de nivel superior es `in_progress` hasta el informe final, y luego `completed` (o `fault` cuando todas las órdenes de laboratorio fallan sin informar): úsalo para saber si el trabajo de laboratorio del pedido de kit de prueba en casa ha terminado. Un [webhook](https://docs.anivahealth.com/es/concepts/webhooks.md) `home_kit_order.results.completed` te avisa cuando esto ocurre, así que no necesitas hacer polling. Los PDF de los informes de laboratorio se referencian en el array `documents`: usa `GET /api/v1/documents/{id}` para descargarlos.

## Ejemplo de pedido de kit de prueba en casa

```json theme={null}
{
  "id": "d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a",
  "profile_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "dispatched",
  "delivery_address": {
    "name": "Jane Doe",
    "street": "Friedrichstraße",
    "house_number": "123",
    "postal_code": "10117",
    "city": "Berlin",
    "country_code": "DE",
    "phone": "+4930123456789",
    "email": "jane.doe@example.com"
  },
  "created_at": "2026-04-01T10:00:00Z",
  "updated_at": "2026-04-02T08:00:00Z",
  "profile": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "handle": null,
    "first_name": "Jane",
    "last_name": "Doe",
    "email": "jane.doe@example.com",
    "phone": "+4930123456789",
    "sex": 2,
    "date_of_birth": "1990-06-15",
    "height": 170,
    "weight": 62,
    "language": "de",
    "transactional_emails_enabled": true,
    "created_at": "2026-04-01T09:30:00Z",
    "updated_at": null
  },
  "panels": [
    {
      "panel_id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
      "added_at": "2026-04-01T10:05:00Z"
    }
  ],
  "individual_biomarkers": [
    {
      "biomarker_id": 42,
      "added_at": "2026-04-01T10:07:00Z"
    }
  ],
  "metadata": { "your_order_ref": "ORD-10482" },
  "replaces_home_kit_order_id": null,
  "replacement_reason": null,
  "results_ready_emails": [],
  "lab_code": "7642000123",
  "activated_at": null,
  "shipments": [
    { "id": "K2604021FQ7", "added_at": "2026-04-02T08:00:00Z" },
    { "id": "K260402P3XD", "added_at": "2026-04-02T08:00:00Z" }
  ]
}
```


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