Skip to main content

GET Listar Protocolos

Lista os protocolos da clínica e os do próprio usuário, em ordem alfabética, com os nomes dos CIDs e a contagem de itens por tipo. Protocolo pessoal de outro usuário nunca aparece.

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

Parâmetros de Query​

NomeTipoObrigatórioValores válidosDescrição
ownerstring❌clinic ou mineSem filtro: os da clínica e os seus. clinic: só os da clínica. mine: só os seus
searchstring❌até 100 caracteresBusca no nome ou no código do CID
cidsstring❌até 20 códigos separados por vírgula, cada um com até 10 caracteresCIDs do diagnóstico. O protocolo da categoria (E11) vale para os subcódigos (E11.9); o contrário não
limitnumber❌inteiro de 0 a 100Itens por página. Sem limit, devolve tudo
offsetnumber❌inteiro, mínimo 0Número da página (multiplicado por limit)

Requisição​

curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/medical-protocols?owner=clinic&cids=I10,E11.9' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'

Respostas​

200 Sucesso​

[
{
"id": 31,
"name": "Hipertensão — acompanhamento",
"updatedAt": "2026-11-10T14:00:00.000Z",
"clinic": true,
"cids": [
{
"code": "I10",
"name": "Hipertensão essencial (primária)"
}
],
"itemCounts": {
"prescriptions": 1,
"exams": 1,
"referrals": 0
}
}
]

Com cids informado e nenhum código válido, a resposta é uma lista vazia. owner=mine com API Key (sem usuário) também devolve lista vazia.

400 Requisição inválida​

Retornado quando o corpo ou a query não passam na validação. A lista message traz um item por regra violada, por exemplo:

{
"message": [
"owner must be one of the following values: clinic, mine",
"limit must not be greater than 100"
],
"error": "Bad Request",
"statusCode": 400
}

403 Sem permissão​

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