Sobre esta API

Ficha cadastral de um CNPJ: razão social, nome fantasia, natureza jurídica, porte, capital social, situação cadastral, CNAE principal, endereço, contato e enquadramento no Simples e no MEI.

Envie o CNPJ no path, com ou sem pontuação. CNPJ que não está na base volta com found: false.

Dados abertos da Receita Federal, atualizados todo mês — reference_month informa a competência. Gratuita, com limite de 20 consultas por minuto e 300 por dia.

Fonte dos dados

Receita Federal — dados abertos · Atualização: mensal

Requisição

GET /api/v1/cnpj/{cnpj}

Endpoint público, sem autenticação. Respeite os limites de consulta.

Parâmetros

Campo	Tipo e local	Descrição
`cnpj` Obrigatório	stringpath	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/49670293000103'

1import os
2import requests
3
4response = requests.request(
5    "GET",
6    "https://api.apifordevs.com/api/v1/cnpj/49670293000103",
7    timeout=30,
8)
9response.raise_for_status()
10print(response.json())

1const response = await fetch("https://api.apifordevs.com/api/v1/cnpj/49670293000103", {
2  method: "GET",
3  signal: AbortSignal.timeout(30000),
4});
5if (!response.ok) throw new Error(`HTTP ${response.status}`);
6console.log(await response.json());

Campos de resposta

Campos e tipos publicados no catálogo desta API.

Encontradofoundboolean
CNPJcnpjstring
Mês de referênciareference_monthstring: Mês da base da Receita que respondeu.
Data de extraçãoextracted_atstring: Data em que a Receita extraiu os dados.
Razão socialrazao_socialstring
Nome fantasianome_fantasiastring
Natureza jurídicanatureza_juridicastring
Código da natureza jurídicanatureza_juridica_codigointeger
Porteportestring
Capital socialcapital_socialnumber
Matrizmatrizboolean
Situação cadastralsituacao_cadastralstring

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": "49670293000103",
12      "reference_month": "2026-07",
13      "extracted_at": null,
14      "razao_social": "COIN NODES LTDA",
15      "nome_fantasia": "COIN NODES",
16      "natureza_juridica": "Sociedade Empresária Limitada",
17      "natureza_juridica_codigo": null,
18      "porte": "Demais",
19      "capital_social": 100000,
20      "matriz": true,
21      "situacao_cadastral": "Ativa",
22      "situacao_cadastral_codigo": 2,
23      "data_situacao_cadastral": null,
24      "motivo_situacao_cadastral": null,
25      "data_inicio_atividade": null,
26      "atividade_principal": {
27        "codigo": 6201501,
28        "descricao": "Desenvolvimento de programas de computador sob encomenda"
29      },
30      "endereco": {
31        "tipo_logradouro": null,
32        "logradouro": "AVENIDA PAULISTA",
33        "numero": "1000",
34        "complemento": null,
35        "bairro": "BELA VISTA",
36        "cep": "01310100",
37        "municipio": "SAO PAULO",
38        "municipio_codigo": null,
39        "uf": "SP"
40      },
41      "email": null,
42      "telefone": null,
43      "simples": {
44        "optante_simples": false,
45        "data_opcao_simples": null,
46        "data_exclusao_simples": null,
47        "optante_mei": false,
48        "data_opcao_mei": null,
49        "data_exclusao_mei": null
50      }
51    }
52  ]
53}

Respostas e cobrança

HTTP	Descrição	Cobrança
`200`	Sucesso. CNPJ fora da base também é `200`, com `found: false`.	Sem cobrança
`422` `validation_error`	CNPJ com dígito verificador inválido.	Sem cobrança
`429` `rate_limit_exceeded`	Limite de consultas por minuto ou por dia atingido.	Sem cobrança
`500` `internal_error`	Falha interna.	Sem cobrança
`503` `service_unavailable`	Base da Receita indisponível no momento.	Sem cobrança

Casos de uso

Enriquecimento de cadastro

Preencher razão social, endereço e CNAE no cadastro do cliente a partir do CNPJ digitado, sem o usuário redigitar nada.

Higienização de base

Varrer a carteira e marcar quem está com situação cadastral baixada, suspensa ou inapta antes de faturar.

Antifraude cadastral

Conferir idade do CNPJ, capital social e porte declarados no onboarding — empresa aberta há duas semanas com capital de mil reais pedindo limite alto é sinal, não conclusão.

Notas de integração

Sem quadro societário: nome de sócio pessoa física não é publicado, em respeito à LGPD.

Cadastro de Pessoa Jurídica