Qual endpoint busca empresas por nome ou CNAE?

Use POST /search ou POST /seek para pesquisar empresas brasileiras por razão social, nome fantasia, CNAE, telefone, e-mail, município, estado, CEP e outros filtros.

Existe endpoint para consultar sócios?

Sim. GET /socios/{cnpj} retorna o QSA e GET /socios/relacionados permite localizar empresas relacionadas a um sócio.

A API possui webhooks?

Sim. Os endpoints de monitoramento permitem cadastrar CNPJs, testar webhooks, verificar alterações e consultar logs de entrega.

Existe health check da API?

Sim. GET /v1/status pode ser usado para verificar disponibilidade da API REST em produção.

Sim. Os endpoints retornam respostas em JSON para integração com CRM, ERP, SaaS, marketplaces e sistemas internos.

O MCP substitui a API REST?

Não. O MCP complementa a API REST para agentes de IA executarem consultas estruturadas por linguagem natural.

Documentação API

Referência Técnica

Endpoints da API CNPJ

Esta documentação reúne todos os endpoints da API REST da APICNPJ para consulta de CNPJ, busca de empresas, quadro societário, monitoramento, webhooks e integração com agentes de IA via MCP. Cada endpoint apresenta parâmetros, exemplos de requisição e respostas em JSON.

Visão geral

Endpoints disponíveis para consulta CNPJ, busca empresarial, QSA, webhooks, sistema e MCP

Consulta CNPJGET /v1/cnpj/{cnpj}

Dados completos

Busca EmpresasPOST /search e /seek

Pesquisa avançada

SóciosGET /socios/{cnpj}

QSA e empresas relacionadas

WebhooksPOST /me/monitoramentos

Monitoramento de CNPJ

SistemaGET /v1/status

Health check

MCPPOST https://api.apicnpj.com/mcp

Agentes de IA

Como usar

Fluxo básico para chamar qualquer endpoint da API REST

1Autentique

Envie Authorization: Bearer SUA_API_KEY em endpoints protegidos.

2Escolha o endpoint

Use /v1/cnpj/{cnpj} para dossiê completo, /search ou /seek para busca empresarial.

3Envie parâmetros

Informe path, query ou body JSON conforme a tabela de cada endpoint.

4Leia a resposta

Todos os exemplos retornam JSON estruturado para integração com CRM, ERP, BI e automações.

5Monitore limites

Acompanhe X-RateLimit-* e trate 429 com retry/backoff.

AutenticaçãoBearer Token e API Key LimitesRate limit e headers PlaygroundTeste endpoints MCPAgentes de IA

Exemplos

Requisições essenciais para consulta CNPJ, busca de empresas e busca avançada

Consulta CNPJ

curl "https://api.apicnpj.com/v1/cnpj/05729230000100" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Accept: application/json"

Busca Empresas

curl "https://api.apicnpj.com/search?q=mercado&uf=SP" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Accept: application/json"

Busca Avançada

curl "https://api.apicnpj.com/seek" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"nome":"restaurante","uf":"SP","cnae":"5611201","limit":10}'

MCP Server para IA

POSThttps://api.apicnpj.com/mcpServidor MCP APICNPJ▼

Monitoramento e Webhooks

POSThttps://api.apicnpj.com/me/monitoramentosNOVOCriar monitoramento de CNPJ▼

GEThttps://api.apicnpj.com/me/monitoramentosListar CNPJs monitorados▼

POSThttps://api.apicnpj.com/me/monitoramentos/{id}/testarEnviar webhook de teste▼

POSThttps://api.apicnpj.com/me/monitoramentos/{id}/verificarNOVOVerificar alterações agora▼

GEThttps://api.apicnpj.com/me/monitoramentos/logsLogs de webhooks▼

POSThttps://api.apicnpj.com/admin/monitoramentos/runRodar fila de monitoramento▼

CNPJ

GEThttps://api.apicnpj.com/v1/cnpj/{cnpj}Consulta completa de CNPJ▼

GEThttps://api.apicnpj.com/sintegra/{cnpj}NOVOInscrição Estadual / Sintegra▼

GEThttps://api.apicnpj.com/v1/cnpj/validar/{cnpj}NOVOValidar dígitos verificadores▼

POSThttps://api.apicnpj.com/v1/cnpj/loteNOVOConsulta em lote▼

GEThttps://api.apicnpj.com/cnpj/contato/{cnpj}Contatos de um CNPJ▼

Sócios

GEThttps://api.apicnpj.com/socios/{cnpj}Sócios de um CNPJ▼

GEThttps://api.apicnpj.com/socios/relacionados?nome=&doc=&idade=Empresas relacionadas por sócio▼

Busca

GEThttps://api.apicnpj.com/nome?nome={termo}Busca por nome fantasia ou razão social▼

POSThttps://api.apicnpj.com/search?q={termo}Busca combinada multi-campo▼

GEThttps://api.apicnpj.com/search/cnae?query={termo}Busca CNAE por código ou descrição▼

GEThttps://api.apicnpj.com/search/cidade?query={termo}Busca município por nome▼

Busca Avançada

POSThttps://api.apicnpj.com/seekBusca avançada com múltiplos filtros▼

GEThttps://api.apicnpj.com/seek/cidades?uf={uf}&municipio={municipio}&categoria={slug}Empresas por cidade e categoria CNAE▼

Sistema

GEThttps://api.apicnpj.com/v1/statusStatus da API▼

Erros HTTP

Códigos comuns da API REST

200OK

Requisição processada com sucesso e resposta JSON disponível.

400Bad Request

Parâmetros inválidos, CNPJ malformado ou body JSON incorreto.

401Unauthorized

API Key ausente, inválida ou enviada fora do header Authorization Bearer.

403Forbidden

Token sem permissão, IP bloqueado ou recurso restrito ao administrador.

404Not Found

CNPJ, monitoramento, sócio ou recurso não encontrado.

429Too Many Requests

Limite de requisições excedido para IP, token ou plano contratado.

500Internal Server Error

Erro interno inesperado. Repita depois ou consulte os logs/suporte.

FAQ técnico

Perguntas frequentes sobre endpoints da API CNPJ

Qual endpoint uso para consultar CNPJ?

Use GET /v1/cnpj/{cnpj} para retornar dados cadastrais completos, endereço, CNAE, situação, contatos e sócios quando disponíveis.

Como buscar empresas por nome, CNAE ou localização?

Use POST /search para busca combinada e POST /seek para filtros avançados por razão social, CNAE, telefone, e-mail, município, UF, CEP, capital social e data de abertura.

Como consultar sócios e empresas relacionadas?

Use GET /socios/{cnpj} para QSA e GET /socios/relacionados para localizar empresas associadas ao mesmo sócio.

Como monitorar mudanças cadastrais?

Use os endpoints de monitoramento e webhooks para cadastrar CNPJs, verificar alterações, enviar testes e acompanhar logs de entrega.

Quando usar MCP em vez da API REST?

Use MCP quando agentes de IA precisam consultar CNPJ, buscar empresas ou gerar listas por linguagem natural. Use REST para integrações diretas em sistemas.