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

# Obter resultados do documento

> Ler o estado e os valores laboratoriais extraídos de um documento que carregaste

Lê o estado e os valores de laboratório de um documento que carregaste com
[Carregar documento](https://docs.anivahealth.com/pt/api/documents/upload-document.md). A resposta tem a mesma estrutura que
[Obter resultados de laboratório](https://docs.anivahealth.com/pt/api/appointments/get-results.md) para uma marcação. Consulta
[Resultados](https://docs.anivahealth.com/pt/concepts/results.md) para ver todos os campos.

Apenas respondem documentos carregados num grupo de perfis onde a tua chave lê resultados. Todos os outros
documentos devolvem `404`: lê os respetivos resultados através da marcação ou da encomenda de kit de teste em casa que os originou.

Não precisas de fazer polling. Subscreve os [webhooks](https://docs.anivahealth.com/pt/concepts/webhooks.md) `document.results.updated` ou `document.results.completed`
e chama este endpoint quando chegar um evento.

Requer o âmbito `results_view` no grupo de perfis em que o documento foi carregado.

## Pedido

### Parâmetros de caminho

**id** `string` *required*

ID do documento (UUID) da resposta de carregamento.

### Cabeçalhos

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

O `ETag` de uma resposta anterior. Quando nada mudou, a API responde `304 Not Modified` sem
corpo.

## Resposta

Em caso de sucesso, a API devolve `200 OK` com o objeto de resultados e um cabeçalho `ETag`.

**status** `string` *required*

Um dos seguintes:

* `in_progress` — a Aniva está a extrair os valores.
* `completed` — extração concluída.
* `fault` — a extração falhou.
* `stored` — o documento não tem valores: carregaste-o sem `extract_results` ou não contém
  resultados de laboratório. `stored` é final: não se segue nenhum webhook `document.results.completed`.

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

Os valores extraídos. Cada valor tem `origin: partner_upload`. Um relatório com várias datas de
colheita atribui a cada valor o seu próprio `tested_at`. Nunca é `planned`: um carregamento não encomenda nada.

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

Resultados genéticos. Atualmente vazio para um documento carregado.

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

O próprio documento carregado.

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

Uma entrada para o carregamento. `lab_code` é `null`.

## Respostas de erro

| Estado | Descrição |
| - | - |
| `304` | Não modificado — o etag de `If-None-Match` ainda corresponde. Sem corpo. |
| `400` | Formato de ID inválido. |
| `403` | A tua chave de API não tem o âmbito `results_view`. |
| `404` | Nenhum documento carregado num dos teus grupos de perfis tem este ID. |
| `500` | Erro interno do 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.