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

# Descargar documento

> Descargar un informe de laboratorio por ID de archivo

Descarga un documento de informe de laboratorio por su ID de archivo. Devuelve los bytes sin procesar del archivo con la cabecera `Content-Type` correspondiente. Los ID de documento se obtienen del array `documents` en la respuesta de [Obtener resultados de laboratorio](https://docs.anivahealth.com/es/api/appointments/get-results.md).

Requiere el scope `results_view`.

> [!NOTE]
>
> El acceso se valida frente al perfil propietario del documento. Un documento que hayas subido con [Subir documento](https://docs.anivahealth.com/es/api/documents/upload-document.md) se valida frente al grupo de perfiles bajo el que se subió.

## Solicitud

### Parámetros de ruta

**id** `string` *required*

ID del archivo (UUID) del array `documents` en la respuesta de resultados de la cita.

## Respuesta

Si la solicitud tiene éxito, la API devuelve `200 OK` con los bytes del archivo y cuatro cabeceras. Cada cabecera contiene un campo del array `documents`:

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

`Original-File-Name` usa UTF-8 con codificación porcentual, porque una cabecera no puede incluir todos los caracteres que puede contener un nombre subido. Decodifícalo con `decodeURIComponent` o un equivalente.

`ETag` e `If-None-Match` son las cabeceras estándar de caché HTTP (RFC 9110). Envía el `etag` que tengas en `If-None-Match` para omitir un archivo sin cambios. En ese caso, la API responde `304 Not Modified` sin cuerpo.

## Respuestas de error

| Estado | Descripción |
| - | - |
| `304` | Sin modificar: el etag de `If-None-Match` sigue coincidiendo con el archivo. Sin cuerpo. |
| `400` | Formato de ID no válido: el valor proporcionado no es un UUID válido. |
| `403` | Prohibido: tu clave de API no tiene acceso a esta operación o el documento está fuera de tu contexto de acceso. |
| `404` | Documento no encontrado. |
| `500` | Error interno del 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.