Skip to main content

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​

NomeTipoObrigatórioValores válidosDescrição
limitnumber❌0–100Itens por página (padrão: 50)
offsetnumber❌>= 0Página atual — o deslocamento é offset × limit (padrão: 0)
searchstring❌qualquerNome(s) do procedimento. Aceita vários separados por vírgula
showSuppliersboolean❌true, falseInclui os fornecedores de cada procedimento
searchWithAiboolean❌true, falseUsa busca semântica por IA (embeddings) em vez de busca por nome
filterstring❌pending_modality ou imageRecorte das abas da lista. pending_modality: procedimentos de imagem sem modalidade; image: só procedimentos de imagem
cursornumber❌inteiro positivoId 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.