# IaBula API

> Brazilian pharmaceutical data structured for software. Independent, informational API; no medical advice or official regulatory endorsement.

## Documentation — PT-BR / English

- [API de medicamentos do Brasil](https://iabula.com/docs.md): Integre dados farmacêuticos brasileiros com busca de medicamentos, registros canônicos, proveniência regulatória e resolução conservadora de nomes.
- [Primeiros passos com a IaBula API](https://iabula.com/docs/getting-started.md): Crie sua conta, configure uma chave de API e faça uma busca de medicamentos com exemplos cURL, JavaScript e Python.
- [Autenticação e chaves de API](https://iabula.com/docs/authentication.md): Entenda X-API-Key, autenticação RapidAPI, sessões do portal e boas práticas para proteger credenciais da IaBula.
- [Busca e registros de medicamentos](https://iabula.com/docs/medications.md): Busque medicamentos brasileiros por nome, filtre registros e consulte detalhes canônicos com paginação por cursor e evidência.
- [Normalização e resolução de nomes farmacêuticos](https://iabula.com/docs/resolve.md): Integre POST /v1/resolve e trate resolved e unresolved com segurança, sem presumir uma variante única para qualquer nome.
- [Princípios ativos, ingredientes e DCB](https://iabula.com/docs/ingredients.md): Consulte ingredientes pelo UUID canônico e entenda a diferença entre DCB, texto da fonte e identidade de princípio ativo.
- [Relações farmacêuticas com evidência](https://iabula.com/docs/relations.md): Consulte relações tipadas entre medicamentos e interprete corretamente respostas vazias e evidências regulatórias.
- [Consulta de alterações de medicamentos e fontes](https://iabula.com/docs/changes.md): Sincronize sua integração pelo feed /v1/changes, usando since e next_cursor sem confundir mudanças de fonte com conclusões regulatórias.
- [Dados ANVISA, CMED e DCB: proveniência](https://iabula.com/docs/provenance.md): Entenda as fontes brasileiras, classes de evidência e limites de cobertura da IaBula antes de interpretar registros farmacêuticos.
- [Erros, limites e retries da API](https://iabula.com/docs/errors.md): Trate Problem Details, HTTP 400, 401, 403, 404, 429 e 503; respeite Retry-After e diferencie unresolved de indisponibilidade.
- [Integrar a IaBula pelo RapidAPI](https://iabula.com/docs/rapidapi.md): Acesse a IaBula no Hub RapidAPI, escolha um plano e use a autenticação nativa do marketplace com o mesmo contrato V1.
- [Como buscar medicamento por nome via API](https://iabula.com/docs/guides/buscar-medicamento-por-nome.md): Implemente busca de medicamentos no Brasil com filtros, paginação, detalhes por UUID e tratamento de ausência de resultados.
- [Como normalizar nomes de medicamentos com segurança](https://iabula.com/docs/guides/normalizar-nome-de-medicamento.md): Projete uma integração conservadora de nomes farmacêuticos e encaminhe consultas unresolved para revisão sem gerar identidades falsas.
- [Como consultar dados ANVISA de medicamentos via API](https://iabula.com/docs/guides/consultar-medicamento-anvisa-api.md): Encontre registros farmacêuticos com origem ANVISA na IaBula e interprete registros, titulares e categorias com proveniência.
- [Como consultar princípio ativo e DCB na API](https://iabula.com/docs/guides/obter-principio-ativo.md): Distinga texto de princípio ativo de ingrediente canônico e consulte registros DCB usando identificadores aprovados da IaBula.
- [Referência da API REST V1](https://iabula.com/docs/api-reference.md): Parâmetros, schemas e respostas dos endpoints IaBula V1 a partir do OpenAPI do aplicativo; acesse também Swagger e JSON.
- [Brazilian pharmaceutical data API](https://iabula.com/docs/en.md): Integrate Brazilian medication data with canonical records, medication search, regulatory provenance and conservative name resolution.
- [Get started with the IaBula API](https://iabula.com/docs/en/getting-started.md): Create your account, configure an API key and search medications using cURL, JavaScript and Python examples.
- [Authentication and API keys](https://iabula.com/docs/en/authentication.md): Understand X-API-Key, RapidAPI authentication, portal sessions and safe credential handling for IaBula integrations.
- [Medication search and canonical records](https://iabula.com/docs/en/medications.md): Search Brazilian medications by name, filter records and retrieve canonical details with cursor pagination and evidence.
- [Medication name normalization and resolution](https://iabula.com/docs/en/resolve.md): Integrate POST /v1/resolve and handle resolved and unresolved safely without assuming every name identifies a unique variant.
- [Active ingredients and Brazilian DCB records](https://iabula.com/docs/en/ingredients.md): Retrieve ingredients by canonical UUID and understand DCB records, source text and active-ingredient identity.
- [Pharmaceutical relationships with evidence](https://iabula.com/docs/en/relations.md): Retrieve typed medication relationships and correctly interpret empty responses and regulatory evidence.
- [Medication and source change tracking](https://iabula.com/docs/en/changes.md): Synchronize your integration using /v1/changes, since and next_cursor without confusing source changes with regulatory conclusions.
- [ANVISA, CMED and DCB data provenance](https://iabula.com/docs/en/provenance.md): Understand Brazilian data sources, evidence classes and IaBula coverage limits before interpreting pharmaceutical records.
- [API errors, limits and retries](https://iabula.com/docs/en/errors.md): Handle Problem Details, HTTP 400, 401, 403, 404, 429 and 503; honor Retry-After and distinguish unresolved from unavailability.
- [Integrate IaBula through RapidAPI](https://iabula.com/docs/en/rapidapi.md): Access IaBula in the RapidAPI Hub, choose a plan and use marketplace authentication with the same V1 contract.
- [How to search medications by name via API](https://iabula.com/docs/en/guides/buscar-medicamento-por-nome.md): Build Brazilian medication name search with filters, pagination, UUID-based details and empty-result handling.
- [How to normalize medication names safely](https://iabula.com/docs/en/guides/normalizar-nome-de-medicamento.md): Design conservative pharmaceutical name integration and route unresolved queries to review without creating false identities.
- [How to query ANVISA medication data through an API](https://iabula.com/docs/en/guides/consultar-medicamento-anvisa-api.md): Find pharmaceutical records sourced from ANVISA in IaBula and interpret registrations, companies and categories with provenance.
- [How to retrieve active ingredients and DCB records](https://iabula.com/docs/en/guides/obter-principio-ativo.md): Distinguish active-ingredient text from canonical ingredients and retrieve DCB records using approved IaBula identifiers.
- [V1 REST API reference](https://iabula.com/docs/en/api-reference.md): Parameters, schemas and responses for IaBula V1 endpoints from the application OpenAPI; also access Swagger and JSON.

## Contracts

- [OpenAPI JSON](https://iabula.com/openapi.json): Runtime V1 schemas and security definitions.
- [Full documentation](https://iabula.com/llms-full.txt): Combined Markdown documentation in PT-BR and English.

## Interpretation

Resolve may return unresolved with HTTP 200 and resolved: null. NATULAXE CAPSULA is the verified positive example. Do not infer canonical ingredient identity from active_ingredient_text. Empty relationships do not imply clinical interchangeability or market absence.