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

Esta rota requer o header Authorization: Bearer {accessToken}

---

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

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