---
title: "Documentação do cnpj.ia.br"
description: "Uma API, um servidor MCP, uma chave. Consulta por CNPJ, busca de empresas por filtros e as ferramentas para agentes, com a data da base em toda resposta."
canonical: "https://cnpj.ia.br/docs"
date_modified: 2026-09-02
source: "cnpj.ia.br"
---

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

# Documentação do cnpj.ia.br

Uma API, um servidor MCP, uma chave. Consulta por CNPJ, busca de empresas por filtros e as ferramentas para agentes, com a data da base em toda resposta.

A API REST em `https://api.cnpj.ia.br` e o servidor MCP em `https://mcp.cnpj.ia.br` usam a mesma chave, criada em [app.cnpj.ia.br](https://app.cnpj.ia.br). Toda resposta de consulta e de busca traz `meta.data_as_of`, a data da base da Receita Federal servida, e `meta.credits_charged`, o custo da chamada. O plano Free dá 60 créditos por mês.

## Comece pelo início rápido

Quatro passos: criar a chave, fazer a primeira consulta, ler a resposta e conferir o uso. Leva menos tempo do que ler esta página.

- [Início rápido](https://cnpj.ia.br/docs/inicio-rapido): a primeira consulta em curl, Python, Node, PHP, Ruby, Go e n8n.
- [Autenticação](https://cnpj.ia.br/docs/autenticacao): `Authorization: Bearer`, escopo da chave, rotação e revogação.

## Referência

- [Consulta por CNPJ](https://cnpj.ia.br/docs/consulta-cnpj): `GET /v1/cnpjs/{cnpj}` com perfil `basic` (1 crédito) ou `full` (6 créditos).
- [Busca de empresas](https://cnpj.ia.br/docs/busca-empresas): `GET /v1/cnpjs` com filtros por UF, município, CNAE, porte, situação, Simples, MEI, natureza jurídica, capital e data de abertura.
- [Campos da resposta](https://cnpj.ia.br/docs/campos): todos os campos dos dois perfis, com tipo, nulabilidade, descrição e tabelas de códigos.
- [Referência gerada do OpenAPI](https://cnpj.ia.br/docs/referencia): uma página por operação, com parâmetros, respostas, headers e créditos.

## Operação

- [Créditos, franquia e rate limit](https://cnpj.ia.br/docs/creditos-e-limites): pesos por operação, franquia mensal, requisições por minuto, pacotes e `GET /v1/usage`.
- [Erros e retentativas](https://cnpj.ia.br/docs/erros-e-retentativas): envelope de erro, os códigos estáveis, `Retry-After` e quando repetir a chamada.
- [Servidor MCP](https://cnpj.ia.br/docs/mcp): configuração para Claude, Cursor, Windsurf e OpenAI, as quatro ferramentas e seus custos.

## Dados e uso

- [CNPJ alfanumérico](https://cnpj.ia.br/docs/cnpj-alfanumerico): o novo formato, o dígito verificador e o que muda na API.
- [Dados e frescor](https://cnpj.ia.br/docs/dados-e-frescor): de onde vêm os dados, o ciclo mensal e o que é derivado.
- [Privacidade e uso aceitável](https://cnpj.ia.br/docs/privacidade-e-uso-aceitavel): o que a API entrega, o que nunca entrega e o que você pode fazer com os contatos.

## Mudanças

- [Changelog](https://cnpj.ia.br/docs/changelog): toda mudança na API, nas docs e na base, com data.
- [Versionamento](https://cnpj.ia.br/docs/versionamento): o que é estável em `/v1` e como uma mudança incompatível seria anunciada.

## Por caso de uso

Guias por caso de uso e comparações com alternativas conhecidas.

- [Para agentes](https://cnpj.ia.br/api-cnpj-para-agentes)
- [Para automação](https://cnpj.ia.br/api-cnpj-para-automacao)
- [Para CRM](https://cnpj.ia.br/api-cnpj-para-crm)
- [Para onboarding](https://cnpj.ia.br/api-cnpj-para-onboarding)
- [vs ReceitaWS](https://cnpj.ia.br/comparar/receitaws)
- [vs BrasilAPI](https://cnpj.ia.br/comparar/brasilapi)

## Empresa e suporte

- [Sobre](https://cnpj.ia.br/sobre): quem constrói o cnpj.ia.br e a relação com a Oportunidados.
- [Segurança](https://cnpj.ia.br/seguranca): como reportar uma vulnerabilidade, o que está no escopo e em quais idiomas.
- [Contato](https://cnpj.ia.br/contato): o canal de suporte e o que informar para acelerar o atendimento — a começar pelo `request_id` da resposta.

## Arquivos de máquina

O contrato está em [`openapi.json`](https://cnpj.ia.br/openapi/openapi.json) (versão 1.0.0-draft.3). Há também uma [coleção Postman](https://cnpj.ia.br/postman.json), o [`llms.txt`](https://cnpj.ia.br/llms.txt) e a [tabela de preços em Markdown](https://cnpj.ia.br/pricing.md). Toda página das docs tem uma versão em Markdown no mesmo endereço com `.md` no final.