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
| Nome | Tipo | Obrigatório | Valores válidos | Descrição |
|---|---|---|---|---|
owner | string | ❌ | clinic ou mine | Sem filtro: os da clínica e os seus. clinic: só os da clínica. mine: só os seus |
search | string | ❌ | até 100 caracteres | Busca no nome ou no código do CID |
cids | string | ❌ | até 20 códigos separados por vírgula, cada um com até 10 caracteres | CIDs do diagnóstico. O protocolo da categoria (E11) vale para os subcódigos (E11.9); o contrário não |
limit | number | ❌ | inteiro de 0 a 100 | Itens por página. Sem limit, devolve tudo |
offset | number | ❌ | inteiro, mínimo 0 | Nú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
}