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

# Ottieni risultati del documento

> Leggi lo stato e i valori di laboratorio estratti di un documento che hai caricato

Leggi lo stato e i valori di laboratorio di un documento caricato con
[Carica documento](https://docs.anivahealth.com/it/api/documents/upload-document.md). La risposta ha la stessa struttura di
[Ottieni risultati di laboratorio](https://docs.anivahealth.com/it/api/appointments/get-results.md) per un appuntamento. Consulta
[Risultati](https://docs.anivahealth.com/it/concepts/results.md) per tutti i campi.

Rispondono solo i documenti caricati in un gruppo di profili in cui la tua chiave può leggere i risultati. Ogni altro
documento restituisce `404`: leggi i suoi risultati dall'appuntamento o dall'ordine di kit domiciliare che lo ha generato.

Non devi fare polling. Iscriviti ai [webhook](https://docs.anivahealth.com/it/concepts/webhooks.md) `document.results.updated` o
`document.results.completed` e chiama questo endpoint quando arriva un evento.

Richiede lo scope `results_view` sul gruppo di profili in cui il documento è stato caricato.

## Richiesta

### Parametri di percorso

**id** `string` *required*

ID del documento (UUID) ottenuto dalla risposta di caricamento.

### Header

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

L'`ETag` di una risposta precedente. Se non è cambiato nulla, l'API risponde con `304 Not Modified`
senza body.

## Risposta

In caso di successo, l'API restituisce `200 OK` con l'oggetto dei risultati e un header `ETag`.

**status** `string` *required*

Uno dei seguenti valori:

* `in_progress` — Aniva sta estraendo i valori.
* `completed` — estrazione completata.
* `fault` — estrazione non riuscita.
* `stored` — il documento non contiene valori: lo hai caricato senza `extract_results` oppure non
  contiene risultati di laboratorio. `stored` è definitivo: non segue alcun webhook `document.results.completed`.

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

I valori estratti. Ogni valore ha `origin: partner_upload`. Un referto con più date di
campionamento assegna a ogni valore il proprio `tested_at`. Mai `planned`: un caricamento non ordina nulla.

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

Risultati genetici. Attualmente vuoto per i documenti caricati.

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

Il documento caricato stesso.

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

Una voce per il caricamento. `lab_code` è `null`.

## Risposte di errore

| Stato | Descrizione |
| - | - |
| `304` | Non modificato — l'etag di `If-None-Match` corrisponde ancora. Nessun body. |
| `400` | Formato dell'ID non valido. |
| `403` | La tua chiave API non dispone dello scope `results_view`. |
| `404` | Nessun documento caricato in uno dei tuoi gruppi di profili ha questo ID. |
| `500` | Errore interno del server. |

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