Skip to main content

GET Documentos do Paciente

Reúne os documentos do paciente: arquivos de atendimento (consulta, pré-consulta e triagem), pedidos de laboratório e declarações.

Autenticação necessária

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

Permissão necessária

Exige a permissão read_patients.


Endpoint​

GET https://api-dev.imagemais.com.br/api/patients/{id}/documents

Parâmetros de Rota​

NomeTipoObrigatórioDescrição
idnumber✅ID do paciente

Requisição​

curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/patients/1/documents' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'

Respostas​

200 Sucesso​

{
"files": [
{
"id": 501,
"name": "exame.pdf",
"url": "https://storage.exemplo.com/arquivos/exame.pdf",
"fileType": "application/pdf",
"createdAt": "2026-11-05T13:00:00.000Z",
"origin": "Consulta",
"consultationId": 77,
"preConsultationId": null,
"triageId": null
}
],
"labOrders": [
{
"uuid": "0f6c1c9e-4f7b-4a39-9a6e-2d3f0c0a1b11",
"orderId": 4410,
"status": "COMPLETED",
"createdAt": "2026-11-04T12:00:00.000Z"
}
],
"declarations": [
{
"url": "https://storage.exemplo.com/declarations/abc123/declaracao.pdf",
"key": "declarations/abc123/declaracao.pdf",
"createdAt": "2026-11-03T15:00:00.000Z"
}
]
}

files traz até 100 arquivos (do mais recente ao mais antigo) e origin é Consulta, Pré-consulta ou Triagem. labOrders traz até 50 pedidos e declarations até 50 declarações do armazenamento. Arquivos excluídos não aparecem.

400 Requisição inválida​

Retornado quando o id não é numérico.

{
"message": "Validation failed (numeric string is expected)",
"error": "Bad Request",
"statusCode": 400
}

403 Sem permissão​

{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}

404 Não encontrado​

{
"message": "Paciente não encontrado",
"error": "Not Found",
"statusCode": 404
}