> ## 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 una cita

Obtén los resultados clínicos y genéticos de laboratorio de una cita, junto con las referencias a los documentos PDF de los informes de laboratorio.

Todos los biomarcadores solicitados para la cita aparecen en la respuesta, para que puedas seguir el pedido completo y no solo lo que ya ha llegado. Lee `status` en cada resultado antes de usar su `value`:

* Las pruebas todavía pendientes aparecen con el estado `planned` mientras la cita está en `in_progress`.
* Los resultados que el laboratorio ha entregado pero que **no** deben usarse clínicamente aparecen con el estado `fault` o `undeliverable`, e incluyen un `status_reason` que explica por qué. Un resultado `fault` sigue teniendo su `value` relleno — ese valor es incorrecto. Nunca lo presentes como un hallazgo.
* Los resultados de los que Aniva o el miembro dudan aparecen con el estado `likely_wrong` y un `status_reason`. El valor no está confirmado. No lo muestres como un hallazgo sin revisarlo.

Cada resultado y documento recibido incluye el `lab_code` (código de barras del tubo) con el que se registró, y el array `submissions` enumera cada petición de laboratorio de la extracción de sangre con su propio estado — una extracción repartida en varios tubos o laboratorios se completa petición a petició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 necesitas consultar este endpoint periódicamente. Suscríbete a los [webhooks](https://docs.anivahealth.com/es/concepts/webhooks.md) `appointment.results.updated` o `appointment.results.completed` y llámalo cuando llegue un evento. Las consultas periódicas siguen funcionando como alternativa.

Requiere el scope `results_view`.

## Solicitud

### Parámetros de ruta

**id** `string` *required*

Identificador único (UUID) de la cita de la 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 almacena la respuesta de este endpoint durante 60 minutos para cada clave de API. Una llamada repetida dentro
de este plazo obtiene la respuesta almacenada mientras la cita y sus resultados no cambien. Tras un cambio, obtienes una respuesta
nueva. Las cabeceras `Cache-Status` y `Age` indican que la respuesta está
almacenada y cuál es su antigüedad.

Para enterarte de un cambio al instante, suscríbete a los eventos de webhook `appointment.results.updated`, `appointment.results.completed` y `appointment.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: tu clave de API no tiene acceso a esta operación o la cita está fuera de tu contexto de acceso. |
| `404` | Cita no encontrada. |
| `500` | Error interno del servidor. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/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": "5c1e7a92-3b4d-4f8e-a6c2-9d0b1e2f3a47",
      "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": "8e4f2a61-7c3b-4d9e-b5a1-0f2e3d4c5b68",
      "status": "received",
      "status_reason": null,
      "lab_code": "7642001234",
      "biomarker_id": 93,
      "biomarker_name": "Alanine Aminotransferase (ALT)",
      "category": "Liver",
      "value": 0.33,
      "value_operator": "eq",
      "unit_id": 63,
      "unit": "µkat/L",
      "reference_range_lab": {
        "normal_min": null,
        "normal_max": 0.82,
        "optimal_min": null,
        "optimal_max": null
      },
      "reference_range_lab_absent_reason": null,
      "aniva_range": null,
      "tested_at": "2026-04-05",
      "comment": null,
      "origin": "lab",
      "lab_reported": {
        "name": "GPT (ALT) (S, U/l)",
        "code": "gpt",
        "category": "Klinische Chemie",
        "value": "20",
        "unit": "U/l",
        "reference_range": "< 50",
        "reference_range_min": null,
        "reference_range_max": 49,
        "flag": "normal",
        "result_status": "final",
        "comment": null
      }
    },
    {
      "id": "a2d9c4e7-1f6b-4a3c-8e5d-7b0c9a1f2e36",
      "status": "fault",
      "status_reason": "Sample tube contaminated with manganese — implausibly high value; the lab cancelled the request and asked for a lithium-heparin tube.",
      "lab_code": "7642001234",
      "biomarker_id": 326,
      "biomarker_name": "Manganese, whole blood mixture",
      "category": "Micronutrients",
      "value": 114,
      "value_operator": "eq",
      "unit_id": 24,
      "unit": "µg/L",
      "reference_range_lab": {
        "normal_min": 6,
        "normal_max": 11,
        "optimal_min": null,
        "optimal_max": null
      },
      "reference_range_lab_absent_reason": null,
      "aniva_range": null,
      "tested_at": "2026-04-05",
      "comment": null,
      "origin": "lab",
      "lab_reported": {
        "name": "Mangan (Vollblut, µg/l)",
        "code": "mn",
        "category": "Spurenelemente",
        "value": "114",
        "unit": "µg/l",
        "reference_range": "6 - 11",
        "reference_range_min": 6,
        "reference_range_max": 11,
        "flag": "critical_high",
        "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": "c7b3e1f9-4a2d-4e6c-9b8a-5d1f0e2c3a79",
      "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": "Appointment not found"
}
```


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