> ## 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 del documento

> Consultar el estado y los valores de laboratorio extraídos de un documento que has subido

Lee el estado y los valores de laboratorio de un documento que hayas subido con
[Subir documento](https://docs.anivahealth.com/es/api/documents/upload-document.md). La respuesta tiene la misma estructura que
[Obtener resultados de laboratorio](https://docs.anivahealth.com/es/api/appointments/get-results.md) para una cita. Consulta
[Resultados](https://docs.anivahealth.com/es/concepts/results.md) para conocer cada campo.

Solo responden los documentos subidos bajo un grupo de perfiles en el que tu clave puede leer resultados.
Cualquier otro documento devuelve `404`: consulta sus resultados en la cita o el pedido de kit de prueba en casa que lo generó.

No necesitas hacer polling. Suscríbete a los [webhooks](https://docs.anivahealth.com/es/concepts/webhooks.md) `document.results.updated` o
`document.results.completed` y llama a este endpoint cuando llegue un evento.

Requiere el permiso `results_view` en el grupo de perfiles bajo el que se subió el documento.

## Solicitud

### Parámetros de ruta

**id** `string` *required*

ID del documento (UUID) de la respuesta de subida.

### Cabeceras

**If-None-Match** `string`

El `ETag` de una respuesta anterior. Si no ha cambiado nada, la API responde `304 Not Modified`
sin cuerpo.

## Respuesta

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

**status** `string` *required*

Uno de estos valores:

* `in_progress` — Aniva está extrayendo los valores.
* `completed` — extracción finalizada.
* `fault` — la extracción ha fallado.
* `stored` — el documento no tiene valores: lo subiste sin `extract_results` o no contiene
  resultados de laboratorio. `stored` es definitivo: no le sigue ningún webhook `document.results.completed`.

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

Los valores extraídos. Cada valor incluye `origin: partner_upload`. Un informe con varias fechas
de muestra asigna a cada valor su propio `tested_at`. Nunca es `planned`: una subida no solicita nada.

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

Resultados genéticos. Actualmente está vacío para un documento subido.

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

El propio documento subido.

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

Una entrada para la subida. `lab_code` es `null`.

## Respuestas de error

| Estado | Descripción |
| - | - |
| `304` | Sin modificar: el etag de `If-None-Match` sigue coincidiendo. Sin cuerpo. |
| `400` | Formato de ID no válido. |
| `403` | Tu clave de API no tiene el permiso `results_view`. |
| `404` | Ningún documento subido bajo alguno de tus grupos de perfiles tiene este ID. |
| `500` | Error interno del servidor. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/documents/f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c/results \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "status": "stored",
  "submissions": [{ "lab_code": null, "status": "completed" }],
  "clinical_results": [],
  "genetic_results": [],
  "documents": [
    {
      "id": "f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c",
      "file_name": "20261023 - Arztbrief.pdf",
      "original_file_name": "arztbrief.pdf",
      "origin": "partner_upload",
      "content_type": "application/pdf",
      "etag": "56104b36f860cfd5b41efc716fdf7b6f",
      "size_bytes": 182311,
      "lab_code": null
    }
  ]
}
```


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