---
title: "Referência da API"
description: "Dados de empresas brasileiras por CNPJ: cadastro, contatos, sócios e regime tributário, com a data da base em toda resposta."
canonical: "https://cnpj.ia.br/docs/referencia"
date_modified: 2026-09-02
source: "cnpj.ia.br"
---

docs · base agosto/2026 Atualizado em 02/09/2026

# 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](https://cnpj.ia.br/openapi/openapi.json) · [postman.json](https://cnpj.ia.br/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}`](https://cnpj.ia.br/docs/referencia/get-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`](https://cnpj.ia.br/docs/referencia/search-cnpjs) | Buscar empresas por filtros | por empresa retornada: 1 | `buscar_empresas` |
| `POST` | [`/v1/filters/generate`](https://cnpj.ia.br/docs/referencia/generate-filter) | 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`](https://cnpj.ia.br/docs/referencia/get-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`](https://cnpj.ia.br/docs/referencia/get-status) | Data da base e estado da API | chamada: 0 | — |
| `GET` | [`/v1/demo`](https://cnpj.ia.br/docs/referencia/get-demo) | Demonstração sem chave | chamada: 0 | — |