Referência da API
Dados de empresas brasileiras por CNPJ: cadastro, contatos, sócios e regime tributário, com a data da base em toda resposta.
Referência gerada do contrato openapi.json: versão 1.0.0-draft.3, servidor https://api.cnpj.ia.br. Uma página por operação, com parâmetros, respostas, headers, créditos e ferramenta MCP.
Contrato e coleção para baixar: openapi.json · postman.json.
Autenticação
Chave da conta, criada em app.cnpj.ia.br. Só no header Authorization; nunca em query string.
Formato da chave: cnpj_live_<segredo>.
Consulta
Tudo sobre um CNPJ conhecido.
| Método | Rota | O que faz | Créditos | MCP |
|---|---|---|---|---|
GET | /v1/cnpjs/{cnpj} | Consultar um CNPJ | perfil basic: 1 · perfil full: 6 | consultar_cnpj |
Busca
Encontrar empresas por filtros.
| Método | Rota | O que faz | Créditos | MCP |
|---|---|---|---|---|
GET | /v1/cnpjs | Buscar empresas por filtros | por empresa retornada: 1 | buscar_empresas |
POST | /v1/filters/generate | Gerar filtros de busca a partir de linguagem natural | chamada: 1 | gerar_filtro |
Conta
Uso e franquia da conta.
| Método | Rota | O que faz | Créditos | MCP |
|---|---|---|---|---|
GET | /v1/usage | Uso e franquia da conta | chamada: 0 | ver_uso |
Público
Sem chave: status da base e demonstração.
| Método | Rota | O que faz | Créditos | MCP |
|---|---|---|---|---|
GET | /v1/status | Data da base e estado da API | chamada: 0 | — |
GET | /v1/demo | Demonstração sem chave | chamada: 0 | — |