API pública
Última atualização: 1º de outubro de 2026
O que é
A mesma consulta deste site, em JSON. Uma rota, sem chave, sem cadastro e sem cobrança. Os dados são os mesmos: a base aberta do CNPJ que a Receita Federal publica.
A rota
GET https://api.fichapj.com.br/cnpj/<cnpj> — o CNPJ em 14 posições, sem pontuação, em maiúsculas ou minúsculas. Sem os pontos, a barra e o traço: 19.131.243/0001-97 responde 400.
curl "https://api.fichapj.com.br/cnpj/19131243000197"
A resposta
Três chaves: empresa (uma por CNPJ raiz), estabelecimento (o endereço consultado) e socios (o quadro societário, ou uma lista vazia quando não há — MEI e empresário individual não têm sócios).
{
"empresa": {
"cnpj_basico": "…",
"razao_social": "…",
"porte": { "codigo": "05", "descricao": "Demais" }
},
"estabelecimento": {
"cnpj": "…",
"situacao_cadastral": { "codigo": "02", "descricao": "Ativa" },
"municipio": { "codigo": "7107", "descricao": "SAO PAULO" },
"uf": "…"
},
"socios": [
{
"nome_socio": "…",
"identificador_socio": { "codigo": "2", "descricao": "Pessoa física" },
"qualificacao_socio": { "codigo": "49", "descricao": "Sócio-Administrador" }
}
]
}Os nomes dos campos são os do layout da Receita Federal. Todo campo que no dump é um código volta como { "codigo", "descricao" }, já resolvido contra as tabelas da Receita — e um código sem linha na tabela volta com descricao nulo, sem sumir da resposta.
Os campos
Quatro tipos. texto é a string como o dump a escreve — em maiúsculas quando é nome, rua ou bairro. data é AAAAMMDD, sem separador. código é o par acima, e lista é uma lista dele.
empresa
A empresa
cnpj_basicotexto- As oito primeiras posições do CNPJ. A matriz e todas as filiais trazem o mesmo.
razao_socialtexto- O nome da empresa, em maiúsculas.
natureza_juridicacódigo- A forma jurídica: limitada, sociedade anônima, associação.
Enquadramento
portecódigo- Microempresa, pequeno porte ou demais.
capital_socialtexto- Como o dump escreve: "1000,00" — ponto no milhar, vírgula no decimal.
qualificacao_responsavelcódigo- Quem responde pela empresa na Receita.
ente_federativotexto- O nome do ente, e só em órgão público. Vazio numa empresa.
estabelecimento
Identificação
cnpjtexto- As 14 posições, sem pontuação.
cnpj_basicotexto- As oito primeiras.
cnpj_ordemtexto- As quatro seguintes, que separam as filiais.
cnpj_dvtexto- Os dois dígitos verificadores.
identificador_matriz_filialcódigo- Matriz ou filial.
nome_fantasiatexto- O nome de fachada. Vazio em quem não tem.
Situação
situacao_cadastralcódigo- Ativa, suspensa, inapta, baixada ou nula.
data_situacao_cadastraldata- Quando a situação passou a valer.
motivo_situacao_cadastralcódigo- A razão da situação, e só fora de ativa.
situacao_especialtexto- Uma anotação da Receita fora da situação cadastral. Vazio na maioria.
data_situacao_especialdata- Quando a anotação foi feita.
Atividade
cnae_fiscal_principalcódigo- A atividade principal.
cnae_fiscal_secundarialista- As secundárias, na ordem do dump. Vazia quando não há.
data_inicio_atividadedata- Quando a empresa começou a operar.
Endereço
tipo_logradourotexto- RUA, AVENIDA, TRAVESSA — sem o nome.
logradourotexto- O nome da rua, em maiúsculas.
numerotexto- Pode vir "S/N".
complementotexto- Sala, andar, bloco.
bairrotexto- Em maiúsculas.
ceptexto- Oito dígitos, sem traço.
municipiocódigo- O código da Receita, que não é o do IBGE.
uftexto- A sigla do estado.
paiscódigo- O vazio é resolvido para o Brasil.
nome_cidade_exteriortexto- A cidade, e só num endereço fora do Brasil.
Contato
ddd_1texto- O DDD do primeiro telefone.
telefone_1texto- O número, só dígitos.
ddd_2texto- O DDD do segundo telefone.
telefone_2texto- O número do segundo, só dígitos.
ddd_faxtexto- O DDD do fax.
faxtexto- O número do fax. Quase sempre vazio.
correio_eletronicotexto- O e-mail de contato.
socios
O sócio
identificador_sociocódigo- Pessoa física, pessoa jurídica ou estrangeiro — o tipo de sócio, já que o documento dele não vem.
nome_sociotexto- O nome da pessoa ou a razão social.
qualificacao_sociocódigo- Sócio-administrador, sócio, titular.
data_entrada_sociedadedata- Quando entrou na sociedade.
faixa_etariacódigo- Só para pessoa física — numa empresa, "Não se aplica".
paiscódigo- Só o sócio estrangeiro tem outro: o vazio é resolvido para o Brasil.
Representante legal
nome_representantetexto- Quem representa o sócio, quando ele é empresa ou estrangeiro.
qualificacao_representante_legalcódigo- A qualificação de quem representa.
Dois dados da Receita não saem daqui. O CPF ou CNPJ do sócio e do representante legal, que ela já publica com o meio em asteriscos — e mesmo assim fica de fora. E a opção pelo Simples Nacional e pelo MEI, que vem num arquivo à parte e esta API ainda não devolve.
Erros
O corpo é sempre { "message": "..." }.
400— o CNPJ não tem o formato de 14 posições.404— CNPJ válido que não está na base. Vale tanto para empresa que não existe quanto para a que ficou de fora do dump.429— passou do limite abaixo. Espere e repita.5xx— erro nosso. Repita mais tarde.
Limites
Dez requisições por segundo, com picos de vinte. O teto é um só para todo mundo — este site entra na mesma fila —, então uma varredura em massa responde 429 para os outros. Se você precisa da base inteira, baixe direto da Receita Federal: ela é pública.
A API não manda cabeçalhos CORS, então chame do seu servidor. Do navegador, uma página de outro domínio não consegue ler a resposta.
MCP
A mesma consulta, como ferramenta de agente: https://fichapj.com.br/mcp, um servidor MCP remoto. Uma ferramenta só, lookup_cnpj, que aceita o CNPJ com ou sem pontuação e devolve o mesmo JSON da rota acima — sem chave, como o resto.
Em qualquer cliente MCP, aponte a URL acima onde ele guarda os servidores. O formato que quase todos usam:
{
"mcpServers": {
"fichapj": { "url": "https://fichapj.com.br/mcp" }
}
}O MCP entra na mesma fila de dez requisições por segundo — não é cota à parte.
Os dados
A base é uma fotografia, não um espelho: uma mudança feita hoje só aparece na publicação seguinte da Receita, o que pode levar semanas. É a mesma ressalva dos Termos de Uso — os dados vêm como vieram, sem conferência nossa.