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

# Obtén els resultats d'un document

> Llegeix l'estat i els valors de laboratori extrets d'un document que has pujat

Llegeix l'estat i els valors de laboratori d'un document que hagis pujat amb
[Puja un document](https://docs.anivahealth.com/ca/api/documents/upload-document.md). La resposta té la mateixa estructura que
[Obtén els resultats de laboratori](https://docs.anivahealth.com/ca/api/appointments/get-results.md) per a una cita. Consulta
[Resultats](https://docs.anivahealth.com/ca/concepts/results.md) per a cada camp.

Només responen els documents pujats en un grup de perfils en què la teva clau pot llegir resultats. Qualsevol altre
document retorna `404`: llegeix-ne els resultats a la cita o a la comanda del kit de prova a casa que l'ha generat.

No cal que facis consultes periòdiques. Subscriu-te als [webhooks](https://docs.anivahealth.com/ca/concepts/webhooks.md) `document.results.updated` o `document.results.completed`
i crida aquest punt final quan arribi un esdeveniment.

Requereix l'àmbit `results_view` al grup de perfils en què es va pujar el document.

## Sol·licitud

### Paràmetres de ruta

**id** `string` *required*

ID del document (UUID) de la resposta de pujada.

### Capçaleres

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

L'`ETag` d'una resposta anterior. Si no ha canviat res, l'API respon `304 Not Modified` sense
cos.

## Resposta

Si té èxit, l'API retorna `200 OK` amb l'objecte de resultats i una capçalera `ETag`.

**status** `string` *required*

Un dels següents:

* `in_progress` — Aniva està extraient els valors.
* `completed` — extracció completada.
* `fault` — l'extracció ha fallat.
* `stored` — el document no té valors: l'has pujat sense `extract_results` o no conté
  resultats de laboratori. `stored` és definitiu: no s'enviarà cap webhook `document.results.completed`.

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

Els valors extrets. Cada valor porta `origin: partner_upload`. Un informe amb diverses dates de
mostra assigna a cada valor el seu propi `tested_at`. Mai `planned`: una pujada no fa cap comanda.

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

Resultats genètics. Actualment buit per als documents pujats.

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

El mateix document pujat.

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

Una entrada per a la pujada. `lab_code` és `null`.

## Respostes d'error

| Estat | Descripció |
| - | - |
| `304` | No modificat — l'etag d'`If-None-Match` continua coincidint. Sense cos. |
| `400` | Format d'ID no vàlid. |
| `403` | La teva clau API no té l'àmbit `results_view`. |
| `404` | No hi ha cap document pujat en cap dels teus grups de perfils amb aquest ID. |
| `500` | Error intern 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.