Para que serve
Traz a ficha cadastral do CNPJ na Receita Federal: razão social, situação, atividades econômicas, natureza jurídica, porte, endereço, capital social e, se pedido, o quadro de sócios e administradores. É a base para cadastrar clientes, fornecedores e parceiros pessoa jurídica.
Ideal para
Por que usar
Situação e atividade num retorno só
Confira se a empresa está ativa e se a atividade declarada combina com o negócio.
Sócios quando precisar
Peça o quadro societário com qsa=true só nas consultas em que ele importa.
Prova para auditoria
Comprovante em PDF da consulta, com data e hora, guardado por 90 dias para anexar ao processo de crédito ou de compliance.
Parâmetros
| Parâmetro | Descrição | Regra |
|---|---|---|
cnpj | CNPJCNPJ da empresa, somente dígitos ou formatado. | Obrigatório |
qsa | Quadro societárioInclui o quadro societário (sócios e administradores) no retorno. Opcional, padrão: não. | Opcional |
O que você recebe
29 campos no retorno, como o seu sistema recebe.
numeroInscricaoCNPJ
Número do CNPJ da empresa ou do estabelecimento.
matrizMatriz
Verdadeiro para a matriz, falso para filial.
nomeEmpresarialRazão social
Nome empresarial registrado.
nomeFantasiaNome fantasia
Nome comercial do estabelecimento.
dataAberturaData de abertura
Data de abertura ou de constituição da pessoa jurídica.
portePorte
Porte da empresa na Receita Federal.
naturezaJuridicaNatureza jurídica
Código e descrição da natureza jurídica.
atividadeEconomicaPrincipalAtividade econômica principal
CNAE principal, com código e descrição.
atividadesEconomicasSecundariasAtividades secundárias
Lista de CNAEs secundários, com código e descrição.
situacaoCadastralSituação cadastral
Situação do cadastro no órgão (ex.: Regular, Ativa, Suspensa, Baixada).
dataSituacaoCadastralData da situação cadastral
Desde quando a situação cadastral vale.
motivoSituacaoCadastralMotivo da situação
Motivo informado para a situação cadastral.
situacaoEspecialSituação especial
Situação especial da empresa, quando houver (ex.: em liquidação).
dataSituacaoEspecialData da situação especial
Desde quando a situação especial vale.
logradouroDado pessoalLogradouro
Rua, avenida ou estrada do endereço.
numeroDado pessoalNúmero
Número do endereço.
complementoDado pessoalComplemento
Complemento do endereço.
bairroDistritoBairro
Bairro ou distrito.
cepDado pessoalCEP
Código de Endereçamento Postal.
municipioMunicípio
Nome do município.
ufUF
Sigla do estado.
enderecoEletronicoDado pessoalE-mail
Endereço eletrônico registrado na fonte.
telefoneDado pessoalTelefone
Telefone de contato registrado na fonte.
efrEnte federativo responsável
Ente federativo responsável, para órgãos públicos.
capitalSocialQSACapital social
Capital social declarado.
emRecuperJudicialEm recuperação judicial
Indica se a empresa está em recuperação judicial.
sociosDado pessoalQuadro societário
Sócios e administradores, com qualificação, documento e representante legal. Vem preenchido quando a consulta pede qsa=true.
dataEmissaoData de emissão
Data de emissão do documento ou da certidão.
dataConsultaData da consulta
Data e hora em que a fonte foi consultada.
Opções da chamada
assincrono=trueProcessa em segundo plano e devolve 202 com o consultaId.comprovante=trueGera também o comprovante da consulta em PDF (custo adicional).
Códigos de resposta
200Sucesso — Consulta concluída; o retorno traz os dados da fonte.202Em processamento — Recupere em GET /api/Marketplace/Consulta/Resultado/{consultaId}. Recuperar não é cobrado.422Requisição inválida — Parâmetros validados antes de qualquer cobrança.429Limite simultâneo — Até 5 consultas simultâneas por cliente.503Em manutenção — A consulta está temporariamente indisponível; nada é cobrado.
Como é cobrado
- Débito por chamada — do saldo pré-pago ou do contrato pós-pago
- Preço exibido na plataforma antes de executar
- Falhas estornadas automaticamente
- Mesmo preço na plataforma e na API
curl "https://api.agrolitics.com.br/api/Marketplace/Consulta/receita-federal-pessoa-juridica?cnpj=00000000000" \ -H "X-Api-Key: $AGROLITICS_API_KEY"{ "metaDados": { "consultaId": "3f9c2a71-5b8e-4d1a-9c07-1e6b2f8a4d90", "apiIdentificador": "receita-federal-pessoa-juridica", "apiNome": "Receita Federal - Pessoa Jurídica", "fonte": "Receita Federal do Brasil", "status": "Concluída", "resultado": "Sucesso", "tempoExecucaoMs": 1840, "assincrono": false, "urlComprovante": null }, "retorno": { /* dados da fonte — variam por consulta */ }}Perguntas frequentes sobre Receita Federal - Pessoa Jurídica
Outras APIs para combinar
Ver catálogo completoReceita Federal - Pessoa Física
Situação do CPF na Receita Federal: regularidade, inscrição e indicador de óbito.
Suframa
Situação cadastral da empresa na Suframa: habilitação e regularidade na Zona Franca de Manaus.
Vínculo Empregatício
Funcionários da empresa pelo CNPJ: quantidade e lista com CPF, nome, data de nascimento, cargo (CBO) e data de admissão.
Comece a integrar
Leve as fontes oficiais do agro para dentro do seu sistema
Crie sua conta e teste qualquer API na plataforma — ou fale com um especialista para desenhar a integração e o contrato ideais para o seu volume.
- APIs de fontes oficiais, com resposta padronizada
- Pague por chamada — sem mensalidade, falhas estornadas
- API do Dossiê BNIR com lotes de até 1.000 CARs
- Webhooks assinados e comprovante em PDF
- Conformidade LGPD — fontes oficiais, log auditável
Solicite uma Demonstração
Nossa equipe entrará em contato em breve.