Skip to main content

GET Buscar Protocolo por ID

Devolve um protocolo completo, com os textos e os itens (na ordem cadastrada).

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


Endpoint​

GET https://api-dev.imagemais.com.br/api/medical-protocols/{id}

Parâmetros de Rota​

NomeTipoObrigatórioDescrição
idnumber✅ID do protocolo

Requisição​

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

Respostas​

200 Sucesso​

{
"id": 31,
"name": "Hipertensão — acompanhamento",
"clinic": true,
"cids": [
{
"code": "I10",
"name": "Hipertensão essencial (primária)"
}
],
"lifestyleAdvice": "Reduzir o sal e praticar atividade física.",
"medicalCertificate": null,
"declaration": null,
"medicalConduct": "Retorno em 30 dias.",
"items": [
{
"type": "PRESCRIPTION",
"text": "Losartana 50 mg",
"category": null,
"data": {
"medicamento": "Losartana",
"dosagem": "50 mg",
"posologia": "1 comprimido ao dia"
},
"procedureId": null
},
{
"type": "EXAM",
"text": "Creatinina",
"category": "laboratorio",
"data": null,
"procedureId": 42
}
],
"updatedAt": "2026-11-10T14:00:00.000Z"
}

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": "Protocolo não encontrado",
"error": "Not Found",
"statusCode": 404
}