Skip to main content

GET Buscar Procedimentos Comuns

Retorna os procedimentos mais utilizados da conta (com mais de uma ocorrência), ordenados por frequência de uso e reordenados conforme os termos buscados.

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/commons

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, 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)
Diferença para Listar Procedimentos

Esta rota retorna apenas procedimentos com mais de 1 ocorrência de uso (procedure_occurrences > 1), ordenados por frequência. Não inclui o campo referral.


Requisição​

curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/procedures/commons?limit=50&search=hemograma,glicose' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'

Respostas​

200 Sucesso​

O retorno é um array de procedimentos, sem envelope data.

[
{
"id": 1,
"name": "HEMOGRAMA COMPLETO",
"synonyms": null,
"price": "35",
"accountId": 1,
"createdAt": "2026-01-10T12:00:00.000Z",
"updatedAt": "2026-01-10T12:00:00.000Z",
"deletedAt": null,
"laudoLocal": false,
"typeId": 2,
"referralId": null,
"discounts": []
}
]