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

# Transferir documento

> Transferir um documento de relatório laboratorial por ID de ficheiro

Descarrega um relatório de laboratório através do respetivo ID de ficheiro. Devolve os bytes em bruto do ficheiro com o cabeçalho `Content-Type` adequado. Os IDs de documento obtêm-se no array `documents` da resposta de [Obter resultados de laboratório](https://docs.anivahealth.com/pt/api/appointments/get-results.md).

Requer o scope `results_view`.

> [!NOTE]
>
> O acesso é validado com base no perfil a que o documento pertence. Um documento que carregaste com [Carregar documento](https://docs.anivahealth.com/pt/api/documents/upload-document.md) é validado com base no grupo de perfis em que foi carregado.

## Pedido

### Parâmetros de caminho

**id** `string` *required*

ID do ficheiro (UUID) do array `documents` na resposta de resultados da marcação.

## Resposta

Em caso de sucesso, a API devolve `200 OK` com os bytes do ficheiro e quatro cabeçalhos. Cada cabeçalho contém um campo do array `documents`:

| Cabeçalho | Campo | Exemplo |
| - | - | - |
| `Content-Type` | `content_type` | `application/pdf` |
| `Content-Disposition` | `file_name` | `attachment; filename="20260405 - Quade Befund - 7642001234.pdf"` |
| `ETag` | `etag` (entre aspas) | `"56104b36f860cfd5b41efc716fdf7b6f"` |
| `Original-File-Name` | `original_file_name` | `7642001234_B0012_FA_E.pdf` |

`Original-File-Name` usa UTF-8 com codificação percentual, porque um cabeçalho não suporta todos os caracteres que um nome carregado pode conter. Descodifica-o com `decodeURIComponent` ou equivalente.

`ETag` e `If-None-Match` são os cabeçalhos HTTP padrão de cache (RFC 9110). Envia o `etag` que tens em `If-None-Match` para ignorar um ficheiro inalterado. A API responde então `304 Not Modified` sem corpo.

## Respostas de erro

| Estado | Descrição |
| - | - |
| `304` | Não modificado — o etag de `If-None-Match` ainda corresponde ao ficheiro. Sem corpo. |
| `400` | Formato de ID inválido — o valor indicado não é um UUID válido. |
| `403` | Proibido — a tua chave de API não tem acesso a esta operação ou o documento está fora do teu contexto de acesso. |
| `404` | Documento não encontrado. |
| `500` | Erro interno do servidor. |

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

```text 200 theme={null}
(Binary file content — save the response to a file)
```

```json 404 theme={null}
{
  "error": "Document not found"
}
```


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