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

Esta rota requer o header Authorization: Bearer {accessToken}

---

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

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": 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,
    "referral": null,
    "discounts": [
      {
        "id": 7,
        "name": "Promoção Janeiro",
        "percentage": "10",
        "fixed": null
      }
    ],
    "procedureSuppliers": [
      {
        "id": 15,
        "procedureId": 1,
        "supplierId": 3,
        "cost": "12",
        "estimate": 24,
        "code": "LAB-001",
        "createdAt": "2026-01-10T12:00:00.000Z",
        "updatedAt": "2026-01-10T12:00:00.000Z",
        "deletedAt": null,
        "supplier": {
          "id": 3,
          "name": "Laboratório Central"
        }
      }
    ]
  }
]

Campos condicionais

procedureSuppliers só aparece quando showSuppliers=true. discounts lista apenas descontos individuais ativos e não vencidos.