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
| 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, 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) |
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": []
}
]