CNPJ
Cadastro de Pessoa Jurídica - Plus
AtivaFonte oficialPor requisição● tempo real
GET
/api/v1/cnpj/plusFicha completa de um CNPJ, consultada na Receita Federal no momento da chamada: razão social, situação cadastral e situação especial, CNAE principal e secundários, natureza jurídica, porte, capital social, endereço, contato e o quadro de sócios e administradores.
Envie o CNPJ em cnpj, com ou sem pontuação. Os campos vêm com os nomes e no formato em que a Receita publica, e os normalizado_* trazem datas, CEP e capital social prontos para uso; consulta_datahora diz quando a Receita respondeu.
CNPJ válido que a Receita não tem volta com found: false e é cobrado: a consulta foi feita. CNPJ com dígito verificador inválido volta 422 e não é cobrado.
Fonte dos dados: Receita Federal — consulta na hora · tempo real
Campos da resposta
Dados que esta API devolve em cada chamada.
Na página
Encontrado
foundCNPJcnpjCNPJ (só dígitos)normalizado_cnpjRazão socialrazao_socialNome fantasianome_fantasiaMatriz ou filialmatriz_filialData de aberturaabertura_dataNatureza jurídicanatureza_juridicaCódigo da natureza jurídicanatureza_juridica_codigoPorteporteCapital socialcapital_socialAtividade principal (CNAE)atividade_economicaCasos de uso
Onde esta API entra no seu processo.
Abrir conta ou contrato com a situação cadastral do dia, não a do mês passado, e conferir quem assina pelo quadro de sócios.
O quadro de sócios traz nome de pessoa física: use com finalidade e base legal, como pede a LGPD.
Testar e integrar
Execute uma chamada e copie o código para a sua aplicação.
GET
https://api.apifordevs.com/api/v1/cnpj/plusChave de API necessária · application/json · 60 req./min · Cobrança apenas em respostas 2xx
Autenticação
AuthorizationheaderInjetado automaticamenteChave de API em Basic: public_key:secret_key em Base64.
Sessão do painel · ••••••••
X-Project-IdheaderInjetado automaticamenteProjeto que recebe a chamada. Sem ele, vale o projeto padrão da conta.
Projeto selecionado no painel
Idempotency-KeyheaderOpcionalRepetir a mesma chave em até 24 horas devolve a resposta anterior, sem executar nem cobrar de novo.
Parâmetros
stringqueryObrigatório
Com ou sem pontuação. O dígito verificador é conferido antes da consulta.
A simulação devolve um exemplo sem chamar o serviço nem cobrar. A execução pede confirmação antes da cobrança.
Execute a requisição para ver a resposta aqui.
Exemplos de requisição
curl -X GET 'https://api.apifordevs.com/api/v1/cnpj/plus?cnpj=49670293000103&summary=true' \ -u "afd_live_pk_...:$APIFORDEVS_LIVE_SECRET" \ -H 'X-Project-Id: proj_...'Exemplo de resposta
CnpjPlusOutput{ "success": true, "code": 200, "code_message": "A requisição foi processada com sucesso.", "errors": [], "header": null, "data_count": 1, "data": [ { "found": true, "cnpj": "49.670.293/0001-03", "normalizado_cnpj": "49670293000103", "razao_social": "COIN NODES LTDA", "nome_fantasia": "COIN NODES", "matriz_filial": "MATRIZ", "abertura_data": "22/02/2023", "natureza_juridica": "206-2 - Sociedade Empresária Limitada", "natureza_juridica_codigo": "2062", "porte": "ME", "capital_social": "1.300.000,00", "atividade_economica": "66.19-3-99 - Outras atividades auxiliares dos serviços financeiros não especificadas anteriormente", "atividade_economica_secundaria": "74.90-1-04 - Atividades de intermediação e agenciamento de serviços e negócios em geral, exceto imobiliários", "atividade_economica_secundaria_lista": [ "74.90-1-04 - Atividades de intermediação e agenciamento de serviços e negócios em geral, exceto imobiliários" ], "endereco_logradouro": "AV ENG LUIZ CARLOS BERRINI", "endereco_numero": "1748", "endereco_complemento": "CONJ 1710", "endereco_bairro": "CIDADE MONCOES", "endereco_cep": "04.571-000", "endereco_municipio": "SAO PAULO", "endereco_uf": "SP", "email": "CONTATO@COINNODES.TECH", "telefone": "(11) 9830-6633", "efr": "*****", "situacao_cadastral": "ATIVA", "situacao_cadastral_data": "22/02/2023", "situacao_cadastral_observacoes": " ", "situacao_especial": "********", "situacao_especial_data": "********", "qsa": [ { "nome": "GUILHERME MELO LOIOLA DE SOUSA", "qualificacao": "49-Sócio-Administrador", "nome_representante_legal": "", "qualificacao_representante_legal": "", "pais_origem": "" } ], "certidao_baixa": {}, "licenciamento_dispensado": [], "constituicao_data": "22/02/2023", "inscricao_data": "", "consulta_datahora": "17/10/2026 10:58:09", "normalizado_abertura_data": "22/02/2023", "normalizado_capital_social": 1300000, "normalizado_consulta_datahora": "17/10/2026 10:58:09", "normalizado_endereco_cep": "04571000", "normalizado_situacao_cadastral_data": "22/02/2023", "normalizado_situacao_especial_data": "" } ]}Códigos de resposta
| Status | errors[].code | Quando acontece | Cobrança |
|---|---|---|---|
| 200 | — | Sucesso. CNPJ que a Receita não tem também é `200`, com `found: false`, e é cobrado. | Sim |
| 400 | bad_request, live_key_cannot_use_dev_mode | Arquivo ou parâmetro que a rota não consegue processar, projeto inválido, ou `dev_mode=true` com chave de produção. | Não |
| 401 | unauthorized | Credencial ausente, inválida ou revogada. | Não |
| 402 | payment_required | Saldo insuficiente ou limite de gasto diário atingido. | Não |
| 403 | forbidden, ip_not_allowed, test_key_cannot_run_live | E-mail da conta não verificado, chave sem escopo para o serviço, IP fora da allowlist do projeto ou chave de teste sem `dev_mode=true`. | Não |
| 409 | conflict | Requisição com a mesma `Idempotency-Key` ainda em andamento. | Não |
| 422 | validation_error | CNPJ com dígito verificador inválido. Não é cobrada. | Não |
| 429 | rate_limit_exceeded | Limite de requisições por minuto da chave atingido. | Não |
| 500 | internal_error | Falha interna. | Não |
| 503 | service_unavailable, upstream_error | Serviço desativado (`service_unavailable`), ou a Receita Federal não respondeu a tempo (`upstream_error`). Não é cobrada; com `upstream_error`, pode ser repetida. | Não |
Preço por consultaR$ 0,30