Sobre esta API

Ficha 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 · Atualização: tempo real

Requisição

GET /api/v1/cnpj/plus

Autenticação HTTP Basic: public_key:secret_key em Base64. Guarde a chave secreta no servidor.

Cabeçalho	Descrição
`Authorization` Obrigatório	Chave de API em Basic: `public_key:secret_key` em Base64.
`X-Project-Id` Opcional	Projeto que recebe a chamada. Sem ele, vale o projeto padrão da conta.
`Idempotency-Key` Opcional	Repetir a mesma chave em até 24 horas devolve a resposta anterior, sem executar nem cobrar de novo.

Parâmetros

Campo	Tipo e local	Descrição
`cnpj` Obrigatório	stringquery	Com ou sem pontuação. O dígito verificador é conferido antes da consulta. Exemplo: `49670293000103`

1curl --request GET 'https://api.apifordevs.com/api/v1/cnpj/plus?cnpj=49670293000103' \
2  --user "afd_live_pk_...:$AFD_SECRET_KEY" \
3  --header "X-Project-Id: $AFD_PROJECT_ID"

1import os
2import requests
3
4response = requests.request(
5    "GET",
6    "https://api.apifordevs.com/api/v1/cnpj/plus?cnpj=49670293000103",
7    auth=("afd_live_pk_...", os.environ["AFD_SECRET_KEY"]),
8    headers={"X-Project-Id": os.environ["AFD_PROJECT_ID"]},
9    timeout=30,
10)
11response.raise_for_status()
12print(response.json())

1const response = await fetch("https://api.apifordevs.com/api/v1/cnpj/plus?cnpj=49670293000103", {
2  method: "GET",
3  headers: {
4    Authorization: "Basic " + Buffer.from(
5      "afd_live_pk_...:" + process.env.AFD_SECRET_KEY
6    ).toString("base64"),
7    "X-Project-Id": process.env.AFD_PROJECT_ID,
8  },
9  signal: AbortSignal.timeout(30000),
10});
11if (!response.ok) throw new Error(`HTTP ${response.status}`);
12console.log(await response.json());

Campos de resposta

Campos e tipos publicados no catálogo desta API.

Encontradofoundboolean
CNPJcnpjstring: Como a Receita escreve: 49.670.293/0001-03.
CNPJ (só dígitos)normalizado_cnpjstring: Só os 14 dígitos.
Razão socialrazao_socialstring
Nome fantasianome_fantasiastring
Matriz ou filialmatriz_filialstring
Data de aberturaabertura_datastring
Natureza jurídicanatureza_juridicastring
Código da natureza jurídicanatureza_juridica_codigostring
Porteportestring
Capital socialcapital_socialstring
Atividade principal (CNAE)atividade_economicastring

Exemplo de resposta

1{
2  "success": true,
3  "code": 200,
4  "code_message": "A requisição foi processada com sucesso.",
5  "errors": [],
6  "header": null,
7  "data_count": 1,
8  "data": [
9    {
10      "found": true,
11      "cnpj": "49.670.293/0001-03",
12      "normalizado_cnpj": "49670293000103",
13      "razao_social": "COIN NODES LTDA",
14      "nome_fantasia": "COIN NODES",
15      "matriz_filial": "MATRIZ",
16      "abertura_data": "22/02/2023",
17      "natureza_juridica": "206-2 - Sociedade Empresária Limitada",
18      "natureza_juridica_codigo": "2062",
19      "porte": "ME",
20      "capital_social": "1.300.000,00",
21      "atividade_economica": "66.19-3-99 - Outras atividades auxiliares dos serviços financeiros não especificadas anteriormente",
22      "atividade_economica_secundaria": "74.90-1-04 - Atividades de intermediação e agenciamento de serviços e negócios em geral, exceto imobiliários",
23      "atividade_economica_secundaria_lista": [
24        "74.90-1-04 - Atividades de intermediação e agenciamento de serviços e negócios em geral, exceto imobiliários"
25      ],
26      "endereco_logradouro": "AV ENG LUIZ CARLOS BERRINI",
27      "endereco_numero": "1748",
28      "endereco_complemento": "CONJ 1710",
29      "endereco_bairro": "CIDADE MONCOES",
30      "endereco_cep": "04.571-000",
31      "endereco_municipio": "SAO PAULO",
32      "endereco_uf": "SP",
33      "email": "CONTATO@COINNODES.TECH",
34      "telefone": "(11) 9830-6633",
35      "efr": "*****",
36      "situacao_cadastral": "ATIVA",
37      "situacao_cadastral_data": "22/02/2023",
38      "situacao_cadastral_observacoes": " ",
39      "situacao_especial": "********",
40      "situacao_especial_data": "********",
41      "qsa": [
42        {
43          "nome": "GUILHERME MELO LOIOLA DE SOUSA",
44          "qualificacao": "49-Sócio-Administrador",
45          "nome_representante_legal": "",
46          "qualificacao_representante_legal": "",
47          "pais_origem": ""
48        }
49      ],
50      "certidao_baixa": {},
51      "licenciamento_dispensado": [],
52      "constituicao_data": "22/02/2023",
53      "inscricao_data": "",
54      "consulta_datahora": "17/10/2026 10:58:09",
55      "normalizado_abertura_data": "22/02/2023",
56      "normalizado_capital_social": 1300000,
57      "normalizado_consulta_datahora": "17/10/2026 10:58:09",
58      "normalizado_endereco_cep": "04571000",
59      "normalizado_situacao_cadastral_data": "22/02/2023",
60      "normalizado_situacao_especial_data": ""
61    }
62  ]
63}

Respostas e cobrança

HTTP	Descrição	Cobrança
`200`	Sucesso. CNPJ que a Receita não tem também é `200`, com `found: false`, e é cobrado.	Sujeita à cobrança
`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.	Sem cobrança
`401` `unauthorized`	Credencial ausente, inválida ou revogada.	Sem cobrança
`402` `payment_required`	Saldo insuficiente ou limite de gasto diário atingido.	Sem cobrança
`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`.	Sem cobrança
`409` `conflict`	Requisição com a mesma `Idempotency-Key` ainda em andamento.	Sem cobrança
`422` `validation_error`	CNPJ com dígito verificador inválido. Não é cobrada.	Sem cobrança
`429` `rate_limit_exceeded`	Limite de requisições por minuto da chave atingido.	Sem cobrança
`500` `internal_error`	Falha interna.	Sem cobrança
`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.	Sem cobrança

Casos de uso

Onboarding de empresa

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.

Análise de crédito

Pesar porte, capital social, idade do CNPJ e situação especial (recuperação judicial, falência) antes de conceder limite.

Conferência de sócios

Confirmar que quem se apresenta como sócio ou administrador está no quadro da empresa na data da consulta.

Notas de integração

O quadro de sócios traz nome de pessoa física: use com finalidade e base legal, como pede a LGPD.

Cadastro de Pessoa Jurídica - Plus