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

# Obtener resultados de laboratorio

> Obtener los resultados de laboratorio clínicos y genéticos de un pedido de kit de prueba en casa

Obtén los resultados de laboratorio clínicos y genéticos de un pedido de kit de prueba en casa, junto con las referencias de los documentos de los informes de laboratorio en PDF.

Todos los biomarcadores solicitados para el kit aparecen en la respuesta, para que puedas seguir el pedido completo y no solo lo que ya ha llegado. Los resultados se registran bajo el `lab_code` del pedido — el pedido al laboratorio se realiza en la [activación](https://docs.anivahealth.com/es/api/home-kit-orders/activate-home-kit.md) y el laboratorio informa los marcadores de uno en uno a medida que se analizan, por lo que es normal recibir una respuesta parcial y el `status` principal permanece en `in_progress` hasta el informe final. Lee el `status` de cada resultado antes de usar su `value`:

* Las pruebas aún pendientes aparecen con el estado `planned` mientras el pedido está en `in_progress`. Puedes llamar a este endpoint antes de la activación — todos los marcadores solicitados aparecen entonces como `planned`.
* Los resultados entregados por el laboratorio que **no** deben usarse clínicamente aparecen con el estado `fault` o `undeliverable`, e incluyen un `status_reason` que explica el motivo. Un resultado `fault` sigue teniendo su `value` relleno — ese valor es erróneo. Nunca lo muestres como un hallazgo.
* Los resultados de los que dudan Aniva o el miembro aparecen con el estado `likely_wrong` y un `status_reason`. El valor no está confirmado. No lo muestres como un hallazgo sin revisión.

Usa [Descargar documento](https://docs.anivahealth.com/es/api/documents/download-document.md) para descargar los PDF de los informes de laboratorio referenciados en el array `documents`.

No hace falta que consultes este endpoint de forma periódica. Suscríbete a los [webhooks](https://docs.anivahealth.com/es/concepts/webhooks.md) `home_kit_order.results.updated` o `home_kit_order.results.completed` y llámalo cuando llegue un evento. Las consultas periódicas siguen funcionando como alternativa.

Requiere el ámbito `results_view` — los resultados de laboratorio y los documentos siempre están protegidos por él, igual que los resultados de una cita y [Descargar documento](https://docs.anivahealth.com/es/api/documents/download-document.md) — más el ámbito `home_kit_orders_view` o `home_kit_orders_manage` para acceder al propio pedido del kit.

## Solicitud

### Parámetros de ruta

**id** `string` *required*

Identificador único (UUID) del pedido de kit de prueba en casa del que quieres obtener los resultados.

## Respuesta

Si la solicitud tiene éxito, la API devuelve `200 OK` con el objeto de resultados.

**status** `string` *required*

Estado general de los resultados. Uno de los siguientes:

* `in_progress` — algunas peticiones siguen en el laboratorio.
* `completed` — todas las peticiones se han cerrado y al menos una ha emitido informe.
* `fault` — todas las peticiones fallaron sin emitir informe. No queda nada pendiente.

**submissions** `object[]` *required*

Una entrada por cada petición de laboratorio — una extracción de sangre repartida en varios tubos o laboratorios tiene
varias. El `status` de nivel superior es `completed` cuando todas las entradas se han cerrado y una ha emitido informe.

**objeto submission**

**lab\_code** `string`

Código de laboratorio (código de barras del tubo) con el que se registró esta petición. Puede ser `null` cuando el laboratorio no registró
ninguno.

**status** `string` *required*

`in_progress` mientras el laboratorio sigue trabajando en ella, `completed` cuando su informe es
definitivo o `fault` cuando la petición fue rechazada o abandonada y nunca emitirá informe — la
muestra suele trasladarse a otro laboratorio, que entonces registra su propia entrada.

**clinical\_results** `object[]` *required*

Array de resultados de biomarcadores clínicos.

**objeto de resultado clínico**

**id** `string`

Identificador de fila del resultado de laboratorio (UUID). Se mantiene igual cuando el laboratorio corrige esa fila, así que úsalo para hacer upsert. `null` para un resultado `planned`.

**status** `string` *required*

Estado del resultado. Uno de:

* `planned` — solicitado, aún no devuelto por el laboratorio. `value` es `null`.
* `received` — entregado por el laboratorio.
* `corrected` — entregado y luego revisado por una persona. `value` es el valor corregido.
* `likely_wrong` — la comprobación automática de Aniva o el miembro duda del valor. Sin confirmar: no lo muestres como hallazgo sin revisarlo. Consulta `status_reason`.
* `fault` — entregado pero confirmado como erróneo; **no usar clínicamente**. `value` contiene la cifra errónea. Consulta `status_reason`.
* `undeliverable` — el laboratorio no pudo obtener un valor. `value` es `null`. Consulta `status_reason`.

**status\_reason** `string` *required*

Por qué el resultado es dudoso o inutilizable. Presente para `likely_wrong`, `fault` y `undeliverable`, `null` para el resto de estados.

Distinto de `comment`, que es la nota propia del laboratorio en el informe — `comment` está vacío en la mayoría de los resultados con fallo, así que toma `status_reason` como la explicación definitiva.

**lab\_code** `string`

Código de laboratorio (código de barras del tubo) con el que se registró el resultado — uno de los códigos de laboratorio del pedido. `null` para un resultado `planned` y para los resultados que el laboratorio informó sin código.

**biomarker\_id** `integer` *required*

Identificador del biomarcador.

**biomarker\_name** `string` *required*

Nombre visible del biomarcador.

**category** `string`

Categoría del biomarcador (p. ej., Hormonas, Vitaminas). Puede ser `null`.

**value** `number`

Valor efectivo del resultado (corregido si está disponible; si no, el original). Puede ser `null`.

**value\_operator** `string`

Operador de comparación del valor: `eq` (igual), `lt` (menor que) o `gt` (mayor que). Puede ser `null`.

**unit\_id** `integer`

Identificador de la unidad de medida. Puede ser `null`.

**unit** `string`

Nombre visible de la unidad de medida. Puede ser `null`.

**reference\_range\_lab** `object`

Intervalos de referencia informados por el laboratorio para **este** resultado, convertidos a la misma unidad que `value`. `null` cuando el laboratorio no informó de ningún intervalo.

Un límite que el laboratorio dejó abierto se queda en `null`, de modo que un intervalo unilateral solo rellena su propio extremo — un umbral superior llega como `normal_min: null, normal_max: 50`, y uno inferior como `normal_min: 55, normal_max: null`. No interpretes un límite `null` como cero ni como sin límite por defecto; interprétalo como "el laboratorio no fijó límite en ese lado".

Cada resultado incluye el intervalo con el que se midió, así que un paciente cuyos resultados abarcan varias extracciones o varios laboratorios obtiene el intervalo correcto para cada resultado en lugar del más reciente.

**intervalo de referencia**

**normal\_min** `number`

Límite inferior del intervalo normal. Puede ser `null`.

**normal\_max** `number`

Límite superior del intervalo normal. Puede ser `null`.

**optimal\_min** `number`

Límite inferior del intervalo óptimo. Puede ser `null`.

**optimal\_max** `number`

Límite superior del intervalo óptimo. Puede ser `null`.

**reference\_range\_lab\_absent\_reason** `string`

Por qué `reference_range_lab` es `null`. `null` cuando `reference_range_lab` está presente y en un resultado `planned`.

* `not_provided`: no existe ningún intervalo. El laboratorio no envió ninguno. Muestra "No aplicable".
* `lab_text_only`: el laboratorio solo imprimió texto, como un objetivo, un nivel de riesgo o un intervalo según la etapa de la vida. Muestra `lab_reported.reference_range`.
* `not_measured`: el resultado es `undeliverable`, por lo que no hay ningún valor para comparar. Muestra `status_reason`.

**aniva\_range** `object`

Valores de comparación recopilados por Aniva, en la misma escala que `value`. Varían según la edad, el sexo y la semana de embarazo. `normal_*` es el intervalo general. `optimal_*` es un intervalo más estrecho. Estos valores son solo informativos. No son consejo médico, ni un diagnóstico ni una valoración del resultado. Aniva no establece ningún indicador a partir de ellos. Usa `reference_range_lab` como referencia del resultado. `null` cuando tu clave no tiene el scope `aniva_ranges_view` o cuando Aniva no tiene valores para este biomarcador.

**intervalo de referencia**

**normal\_min** `number`

Límite inferior del intervalo normal. Puede ser `null`.

**normal\_max** `number`

Límite superior del intervalo normal. Puede ser `null`.

**optimal\_min** `number`

Límite inferior del intervalo óptimo. Puede ser `null`.

**optimal\_max** `number`

Límite superior del intervalo más estrecho. Puede ser `null`.

**sources** `object[]`

Fuentes publicadas que Aniva registró para estos valores. Cada entrada tiene un `title` y una `url`. La `url` puede ser `null`. La lista está vacía cuando Aniva no ha registrado ninguna fuente.

**tested\_at** `string`

Fecha en que se realizó la prueba en formato `YYYY-MM-DD`. Puede ser `null`.

**comment** `string`

Comentario opcional sobre el resultado. Puede ser `null`.

**origin** `string`

Quién entregó el documento del que procede este valor, igual que `origin` en el documento. Un valor de un documento subido procede de la lectura del archivo por parte de Aniva, no de un informe de laboratorio. `null` para un resultado `planned`.

**lab\_reported** `object`

La línea propia del informe del laboratorio que realizó la prueba, tal cual — para comparar este payload con el PDF del laboratorio. Puede ser `null` cuando no tenemos un registro en bruto del resultado.

Todos los demás campos de un resultado están normalizados: `value` y `unit` se convierten a la unidad predeterminada del biomarcador, y `biomarker_name` es nuestro nombre para el analito, no el del laboratorio. Los campos siguientes no lo están. Tómalos como la referencia tal y como aparece impresa y los campos canónicos como comprobación de coherencia.

Los números aquí son los límites propios del laboratorio en su propia escala — `reference_range_min` y `reference_range_max` **no** están convertidos de unidad y diferirán de `reference_range_lab` siempre que ambas escalas difieran. Un límite que el laboratorio dejó abierto se queda en `null`; no se infiere ni se asigna nada por defecto.

**datos del laboratorio**

**name** `string`

Nombre del analito tal como lo imprimió el laboratorio. Puede ser `null`.

**code** `string`

Código propio del analito del laboratorio. Puede ser `null`.

**category** `string`

Encabezado de sección del informe, p. ej. `Klinische Chemie`. Puede ser `null`.

**value** `string`

Valor tal como aparece impreso. Es una cadena de texto para que los resultados no numéricos se conserven intactos (`<0.04`, `negativ`, `1:100`). Puede ser `null`.

**unit** `string`

Unidad tal como aparece impresa, p. ej. `U/l`. Puede ser `null`.

**reference\_range** `string`

Intervalo de referencia tal como aparece impreso, incluidos los umbrales unilaterales: `40 - 129`, `< 50`, `> 55`. Puede ser `null`.

**reference\_range\_min** `number`

Límite inferior del laboratorio, sin convertir. `null` en un intervalo que el laboratorio dejó abierto por abajo.

**reference\_range\_max** `number`

Límite superior del laboratorio, sin convertir. `null` en un intervalo que el laboratorio dejó abierto por arriba.

**flag** `string`

Indicador de anomalía del laboratorio para esta línea: `normal`, `high`, `low`, `critical_high`, `critical_low`, `abnormal`. Si no reconocemos un código, pasa tal como lo envió el laboratorio. Puede ser `null`.

**result\_status** `string`

Estado del resultado según el laboratorio: `final`, `preliminary`, `correction`, `incomplete`, `partial`, `deleted`, `cannot_be_obtained`. Un valor `preliminary` todavía puede revisarse. Un [webhook](https://docs.anivahealth.com/es/concepts/webhooks.md) posterior `results.updated` te avisa de cuándo volver a consultarlo. Puede ser `null`.

**comment** `string`

Nota propia del laboratorio en esta línea. Los espacios de relleno de columnas se reducen; el texto no se modifica. Puede ser `null`.

**genetic\_results** `object[]` *required*

Array de resultados de biomarcadores genéticos.

**objeto de resultado genético**

**id** `string`

Identificador de fila del resultado de laboratorio (UUID). Se mantiene igual cuando el laboratorio corrige esa fila, así que úsalo para hacer upsert. `null` para un resultado `planned`.

**status** `string` *required*

Estado del resultado. Uno de:

* `planned` — solicitado, aún no devuelto por el laboratorio.
* `received` — entregado por el laboratorio.
* `likely_wrong` — la comprobación automática de Aniva o el miembro duda del genotipo. Sin confirmar. Consulta `status_reason`.
* `fault` — entregado pero confirmado como erróneo; **no usar clínicamente**. Consulta `status_reason`.
* `undeliverable` — el laboratorio no pudo obtener un genotipo. Consulta `status_reason`.

**status\_reason** `string` *required*

Por qué el resultado es dudoso o inutilizable. Presente para `likely_wrong`, `fault` y `undeliverable`, `null` para el resto de estados.

**lab\_code** `string`

Código de laboratorio (código de barras del tubo) con el que se registró el resultado. `null` para un resultado `planned` y para los resultados que el laboratorio informó sin código.

**biomarker\_id** `integer` *required*

Identificador del biomarcador (gen).

**gene** `string` *required*

Símbolo del gen (p. ej., APOE, MTHFR).

**genotype** `string`

Genotipo mostrado (p. ej., E3/E4). Puede ser `null`.

**clinical\_significance** `string`

Significado clínico general. Uno de `pathogenic`, `likely_pathogenic`, `uncertain`, `likely_benign`, `benign`, `high_risk`, `moderate_risk`, `low_risk`, `protective`, `drug_response`, `poor_metabolizer` o `rapid_metabolizer`. Puede ser `null`.

**risk\_description** `string`

Descripción del riesgo para este genotipo. Puede ser `null`.

**tested\_at** `string`

Fecha en que se realizó la prueba en formato `YYYY-MM-DD`. Puede ser `null`.

**comment** `string`

Comentario opcional sobre el resultado. Puede ser `null`.

**origin** `string`

Quién entregó el documento del que procede este valor, igual que `origin` en el documento. Un valor de un documento subido procede de la lectura del archivo por parte de Aniva, no de un informe de laboratorio. `null` para un resultado `planned`.

**variants** `object[]` *required*

Variantes genéticas detectadas.

**objeto de variante**

**name** `string` *required*

Nombre común de la variante (p. ej., APOE E4).

**clinical\_significance** `string`

Significado clínico a nivel de variante. Puede ser `null`.

**description** `string`

Descripción de la variante. Puede ser `null`.

**hgvs\_c** `string`

Notación HGVS de ADN codificante. Puede ser `null`.

**hgvs\_p** `string`

Notación HGVS de proteína. Puede ser `null`.

**conditions** `object[]` *required*

Afecciones asociadas.

**objeto de afección**

**condition** `string` *required*

Nombre de la afección o enfermedad.

**association\_description** `string`

Descripción de la asociación entre la variante y la afección. Puede ser `null`.

**badge** `string`

Texto breve de etiqueta para mostrar. Puede ser `null`.

**snvs** `object[]` *required*

Variantes de un solo nucleótido que definen esta variante.

**objeto SNV**

**rs\_id** `string` *required*

Identificador dbSNP (p. ej., rs429358).

**allele** `string` *required*

Alelo de la variante (`A`, `C`, `G`, `T`, `del`, `ins` o `undetermined`).

**reference\_allele** `string` *required*

Alelo de referencia poblacional.

**hgvs\_c** `string`

Notación HGVS de ADN codificante. Puede ser `null`.

**hgvs\_p** `string`

Notación HGVS de proteína. Puede ser `null`.

**documents** `object[]` *required*

Documentos del informe de laboratorio. Usa `GET /api/v1/documents/{id}` para descargar cada archivo.

**objeto de documento**

**id** `string` *required*

Identificador del archivo (UUID). Pásalo a [Descargar documento](https://docs.anivahealth.com/es/api/documents/download-document.md) para obtener el archivo.

**file\_name** `string` *required*

Nombre del archivo. [Descargar documento](https://docs.anivahealth.com/es/api/documents/download-document.md) envía el mismo nombre en `Content-Disposition`. Contiene una fecha, el título del documento y el código de laboratorio, p. ej. `20260405 - Quade Befund - 7642001234.pdf`. Úsalo solo para mostrarlo. Lee el código de laboratorio en `lab_code`, no en el nombre.

**original\_file\_name** `string` *required*

Nombre del archivo exactamente tal como lo entregó el origen, p. ej. `7642100312_B0012_FA_V.pdf` del laboratorio o el nombre propio del miembro al subirlo. Aniva no lo modifica.

**origin** `string` *required*

Quién entregó el archivo. Uno de `lab` (lo envió el laboratorio), `member_upload` (lo subió el miembro), `staff_upload` (lo subió el personal de Aniva) o `partner_upload` (lo subiste tú con [Subir documento](https://docs.anivahealth.com/es/api/documents/upload-document.md)).

**content\_type** `string` *required*

Tipo de medio del archivo, p. ej. `application/pdf`, `image/jpeg` o `text/csv`. La mayoría de los informes de laboratorio son PDF.

**etag** `string`

Versión del contenido del archivo. Cambia cada vez que cambian los bytes, así que compárala con el valor que guardaste para saber si debes volver a descargarlo. [Descargar documento](https://docs.anivahealth.com/es/api/documents/download-document.md) la envía entre comillas como la cabecera HTTP estándar `ETag`. Puede ser `null` cuando falta el archivo almacenado.

**size\_bytes** `integer`

Tamaño del archivo en bytes. Puede ser `null` cuando falta el archivo almacenado.

**lab\_code** `string`

Código de laboratorio (código de barras del tubo) al que pertenece el informe. Puede ser `null` cuando el laboratorio no registró ninguno.

## Llamadas repetidas

Aniva guarda la respuesta de este endpoint durante 60 minutos para cada clave de API. Una llamada repetida dentro de
este plazo recibe la respuesta guardada mientras el pedido de kit de prueba en casa y sus resultados no cambien. Tras un cambio, recibes una respuesta
nueva. Las cabeceras `Cache-Status` y `Age` muestran que la respuesta está
guardada y su antigüedad.

Para enterarte de un cambio al instante, suscríbete a los eventos de webhook `home_kit_order.results.updated`, `home_kit_order.results.completed` y `home_kit_order.results.fault`.
Consulta [Lecturas repetidas](https://docs.anivahealth.com/es/concepts/webhooks.md#lecturas-repetidas).

## Respuestas de error

| Estado | Descripción |
| - | - |
| `400` | Formato de ID no válido — el valor proporcionado no es un UUID válido. |
| `403` | Prohibido — a tu clave de API le falta el ámbito `results_view`, le faltan tanto `home_kit_orders_view` como `home_kit_orders_manage`, o el pedido de kit de prueba en casa está fuera de tu contexto de acceso. |
| `404` | Pedido de kit de prueba en casa no encontrado. |
| `500` | Error interno del servidor. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/home-kit-orders/d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a/results \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "status": "in_progress",
  "submissions": [
    {
      "lab_code": "7642001234",
      "status": "in_progress"
    }
  ],
  "clinical_results": [
    {
      "id": "e9f1a3c5-6b7d-4c2e-8a4f-1d3b5c7e9f02",
      "status": "received",
      "status_reason": null,
      "lab_code": "7642001234",
      "biomarker_id": 104,
      "biomarker_name": "Vitamin D",
      "category": "Vitamins",
      "value": 38.5,
      "value_operator": "eq",
      "unit_id": 1,
      "unit": "ng/mL",
      "reference_range_lab": {
        "normal_min": 30,
        "normal_max": 100,
        "optimal_min": null,
        "optimal_max": null
      },
      "reference_range_lab_absent_reason": null,
      "aniva_range": {
        "normal_min": 30,
        "normal_max": 100,
        "optimal_min": 30,
        "optimal_max": 60,
        "sources": [
          {
            "title": "Example source title",
            "url": "https://example.com/source"
          }
        ]
      },
      "tested_at": "2026-04-05",
      "comment": null,
      "origin": "lab",
      "lab_reported": {
        "name": "Vitamin D (25-OH)",
        "code": "vitd",
        "category": "Endokrinologie",
        "value": "38.5",
        "unit": "ng/ml",
        "reference_range": "30 - 100",
        "reference_range_min": 30,
        "reference_range_max": 100,
        "flag": "normal",
        "result_status": "final",
        "comment": null
      }
    },
    {
      "id": null,
      "status": "planned",
      "status_reason": null,
      "lab_code": null,
      "biomarker_id": 79,
      "biomarker_name": "Thyroid-Stimulating Hormone (TSH)",
      "category": "Hormones",
      "value": null,
      "value_operator": null,
      "unit_id": null,
      "unit": null,
      "reference_range_lab": null,
      "reference_range_lab_absent_reason": null,
      "aniva_range": null,
      "tested_at": null,
      "comment": null,
      "origin": null,
      "lab_reported": null
    }
  ],
  "genetic_results": [
    {
      "id": "1b3d5f7a-9c2e-4a6b-8d0f-2e4a6c8b0d13",
      "status": "received",
      "status_reason": null,
      "lab_code": "7642001234",
      "biomarker_id": 348,
      "gene": "APOE",
      "genotype": "E3/E4",
      "clinical_significance": "moderate_risk",
      "risk_description": "Carriers of one APOE E4 allele have a moderately increased risk of Alzheimer's disease.",
      "tested_at": "2026-04-05",
      "comment": null,
      "origin": "lab",
      "variants": [
        {
          "name": "APOE E4",
          "clinical_significance": "moderate_risk",
          "description": "The E4 allele is associated with increased Alzheimer's risk.",
          "hgvs_c": "c.388T>C",
          "hgvs_p": "p.Cys130Arg",
          "conditions": [
            {
              "condition": "Alzheimer's disease",
              "association_description": "Increased risk with one E4 allele",
              "badge": "Moderate Risk"
            }
          ],
          "snvs": [
            {
              "rs_id": "rs429358",
              "allele": "C",
              "reference_allele": "T",
              "hgvs_c": "c.388T>C",
              "hgvs_p": "p.Cys130Arg"
            }
          ]
        }
      ]
    }
  ],
  "documents": [
    {
      "id": "f8a1b2c3-d4e5-4f6a-7b8c-9d0e1f2a3b4c",
      "file_name": "20260405 - Quade Befund - 7642001234.pdf",
      "original_file_name": "7642001234_B0012_FA_E.pdf",
      "origin": "lab",
      "content_type": "application/pdf",
      "etag": "56104b36f860cfd5b41efc716fdf7b6f",
      "size_bytes": 258341,
      "lab_code": "7642001234"
    }
  ]
}
```

```json 404 theme={null}
{
  "error": "Home kit order not found"
}
```


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