GET Listar Procedimentos
Retorna a lista de procedimentos (exames) da conta, com busca por nome, busca opcional por IA e inclusão opcional de fornecedores.
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_procedures.
Endpoint
GET https://api-dev.imagemais.com.br/api/procedures
Parâmetros de Query
| Nome | Tipo | Obrigatório | Valores válidos | Descrição |
|---|---|---|---|---|
limit | number | ❌ | 0–100 | Itens por página (padrão: 50) |
offset | number | ❌ | >= 0 | Página atual — o deslocamento é offset × limit (padrão: 0) |
search | string | ❌ | qualquer | Nome(s) do procedimento. Aceita vários separados por vírgula |
showSuppliers | boolean | ❌ | true, false | Inclui os fornecedores de cada procedimento |
searchWithAi | boolean | ❌ | true, false | Usa busca semântica por IA (embeddings) em vez de busca por nome |
filter | string | ❌ | pending_modality ou image | Recorte das abas da lista. pending_modality: procedimentos de imagem sem modalidade; image: só procedimentos de imagem |
cursor | number | ❌ | inteiro positivo | Id do último procedimento carregado (paginação por cursor) |
Busca por múltiplos termos
O search é dividido por vírgula; cada termo com mais de 1 caractere vira uma condição de busca. Com searchWithAi=true, os termos são convertidos em embeddings e comparados por similaridade semântica.
Requisição
curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/procedures?limit=50&offset=0&search=hemograma&showSuppliers=true' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'
Respostas
200 Sucesso
O retorno é um array de procedimentos (sem envelope data e sem paginação por cursor).
[
{
"id": 17,
"name": "hemograma",
"synonyms": "hemograma completo, contagem sanguínea, hemograma diferencial, análise de sangue, hemoglobina, hematócrito, contagem de células sanguíneas, exame de sangue, perfil hematológico, avaliação hematológica.",
"price": "12",
"accountId": 1,
"createdAt": "2026-07-23T00:49:10.818Z",
"updatedAt": "2026-08-07T19:44:15.513Z",
"deletedAt": null,
"laudoLocal": false,
"typeId": null,
"referralId": null,
"type": null,
"referral": null,
"discounts": [],
"procedureSuppliers": [
{
"id": 1,
"procedureId": 17,
"supplierId": 1,
"cost": "0",
"estimate": 0,
"code": "HEMO",
"createdAt": "2026-07-23T00:49:31.637Z",
"updatedAt": "2026-08-07T19:44:15.499Z",
"deletedAt": null,
"supplier": {
"id": 1,
"name": "Diagnóstico Brasil",
"accountId": 1,
"createdAt": "2026-07-23T00:49:22.406Z",
"updatedAt": "2026-07-30T11:20:36.687Z",
"deletedAt": null,
"canGenerateLabel": true,
"guideUrl": "https://gde.diagnosticosdobrasil.com.br/exam/{code}",
"isSystem": true
}
}
]
}
]
Campos condicionais
procedureSuppliers só aparece quando showSuppliers=true. discounts lista apenas descontos individuais ativos e não vencidos.