Documentação da API

GET /v1/medicamentos Free+

Busca paginada de medicamentos por nome (20 resultados por página).

Parâmetros (query)

• nome — termo de busca, mínimo 2 caracteres (ex.: dipirona)
• pagina — página do resultado, começa em 1 (opcional)

Exemplo de resposta

{
  "total": 42,
  "pagina": 1,
  "totalPaginas": 3,
  "porPagina": 20,
  "referenciaDados": "2026-06",
  "resultados": [
    {
      "registro": "1234567890123",
      "nome": "Dipirona Sódica",
      "fabricante": "laboratorio-x",
      "principioAtivo": "dipirona-monoidratada",
      "classe": "analgesico",
      "categoria": "generico",
      "tipo": "comprimido",
      "precosCMED": { "pf": 12.34, "pmvg": 10.87, "referencia": "2026-06" },
      "slug": "dipirona-sodica-laboratorio-x"
    }
  ]
}

GET /v1/medicamentos/{registro} Free+

Apresentações de um medicamento pelo número de registro ANVISA.

Parâmetros (path)

• registro — número de registro ANVISA

Exemplo de resposta

{
  "registro": "1234567890123",
  "total": 2,
  "referenciaDados": "2026-06",
  "resultados": [
    {
      "registro": "1234567890123",
      "nome": "Dipirona Sódica",
      "fabricante": "laboratorio-x",
      "principioAtivo": "dipirona-monoidratada",
      "classe": "analgesico",
      "categoria": "generico",
      "tipo": "comprimido",
      "precosCMED": { "pf": 12.34, "pmvg": 10.87, "referencia": "2026-06" },
      "slug": "dipirona-sodica-laboratorio-x"
    }
  ]
}

GET /v1/principios-ativos/{slug} Pro+

Todos os medicamentos de um princípio ativo, com preços CMED — ideal para comparação de genéricos. Resposta paginada (20 por página).

Parâmetros

• slug (path) — princípio ativo em slug (ex.: dipirona-monoidratada)
• pagina (query) — página do resultado, começa em 1 (opcional)

Exemplo de resposta

{
  "total": 18,
  "pagina": 1,
  "totalPaginas": 1,
  "porPagina": 20,
  "referenciaDados": "2026-06",
  "resultados": [
    {
      "registro": "1234567890123",
      "nome": "Dipirona Sódica",
      "fabricante": "laboratorio-x",
      "principioAtivo": "dipirona-monoidratada",
      "classe": "analgesico",
      "categoria": "generico",
      "tipo": "comprimido",
      "precosCMED": { "pf": 12.34, "pmvg": 10.87, "referencia": "2026-06" },
      "slug": "dipirona-sodica-laboratorio-x"
    }
  ]
}

GET /v1/medicamentos/{registro}/bula Pro+

Bula completa do medicamento, em seções estruturadas (JSON, não PDF), a partir do Bulário Eletrônico da ANVISA. Disponível nos planos Pro e Business.

Parâmetros

• registro (path) — nº de registro ANVISA, só dígitos (ex.: 102980568)

Exemplo de resposta

{
  "registro": "102980568",
  "bula": {
    "paraQueServe": "…",
    "comoTomar": "…",
    "contraindicacoes": "…",
    "efeitosColaterais": "…",
    "composicao": "…",
    "precaucoes": "…"
  }
}

Retorna 404 bula_nao_encontrada quando não há bula para o registro.

GET /v1/ean/{codigo} Free+

Busca por código de barras (EAN-13) — ideal para PDV de farmácia e conferência de preço teto CMED no balcão. Resolve o EAN para o registro ANVISA e devolve o medicamento com preços CMED. Cobre ~25 mil EANs da tabela CMED vigente.

Parâmetros

• codigo (path) — EAN-13, só dígitos (ex.: 7891106000956)

Exemplo de resposta

{
  "ean": "7891106000956",
  "registro": "170560023",
  "total": 1,
  "referenciaDados": "2026-06",
  "resultados": [ { "registro": "170560023", "nome": "…", "precosCMED": { … } } ]
}

Retorna 400 ean_invalido se o código não tiver 13 dígitos e 404 ean_nao_encontrado quando o EAN não consta na tabela CMED.