Consulta de CNPJ via API

API REST para consulta de dados cadastrais de empresas brasileiras por CNPJ numérico ou alfanumérico. Dados atualizados mensalmente a partir dos arquivos abertos da Receita Federal.

Base URL https://cnpjs.perta.io/api

Base de dados

73.366.147

Registros importados

Mensal

Frequencia de atualizacao

Receita Federal

Fonte oficial dos dados

Situacao Cadastral

Situacao	Total
Baixada	34.587.462
Ativa	28.263.121
Inapta	10.084.178
Suspensa	321.187
Nula	110.199

Empresas por UF

UF	Total
SP	8.738.350
MG	2.959.782
RJ	2.317.296
PR	2.029.157
RS	1.766.478
SC	1.540.316
BA	1.257.739
GO	1.058.127
CE	747.141
PE	736.762
ES	611.256
MT	569.070
PA	509.081
DF	476.086
MS	386.464
MA	373.965
PB	352.131
RN	312.096
AM	284.560
PI	236.203
AL	233.193
TO	179.337
SE	176.571
RO	174.109
EX	81.065
AC	54.152
RR	51.765
AP	50.869

Quick Start

CNPJ:

bashcurl -H "X-API-Key: SUA_CHAVE" \
     https://cnpjs.perta.io/api/cnpj/33000167000101

Autenticacao

Todas as requisicoes exigem uma chave de API. Envie via header ou query string:

Via header (recomendado)

X-API-Key: SUA_CHAVE

Via query string

https://cnpjs.perta.io/api/cnpj/33000167000101?api_key=SUA_CHAVE

Endpoint

GET /api/cnpj/{cnpj}

O parâmetro {cnpj} aceita CNPJ numérico ou alfanumérico, com máscara (12.ABC.345/01DE-35) ou sem máscara (12ABC34501DE35). As 12 primeiras posições aceitam números e letras de A a Z; os 2 dígitos verificadores finais devem ser numéricos. Letras minúsculas são normalizadas para maiúsculas.

A consulta valida o formato e a existência na base importada. O cálculo matemático dos dígitos verificadores não é usado para rejeitar consultas.

Respostas sao cacheadas por 24 horas.

Resposta de sucesso

200 OK{
  "data": {
    "cnpj": "33000167000101",
    "cnpj_basico": "33000167",
    "cnpj_ordem": "0001",
    "cnpj_dv": "01",
    "razao_social": "PETROLEO BRASILEIRO S A PETROBRAS",
    "nome_fantasia": "PETROBRAS - EDISE",
    "natureza_juridica": "Sociedade de Economia Mista",
    "capital_social": "205431960490.52",
    "porte_empresa": "Demais",
    "situacao_cadastral": "Ativa",
    "data_situacao_cadastral": "2005-11-03",
    "motivo_situacao_cadastral": "SEM MOTIVO",
    "data_inicio_atividade": "1966-09-28",
    "cnae_fiscal_principal": "Extracao de petroleo e gas natural",
    "cnae_fiscal_secundaria": "1921700,3520401,3520402,4681801,8630599",
    "tipo_logradouro": "AVENIDA",
    "logradouro": "REPUBLICA DO CHILE",
    "numero": "65",
    "complemento": null,
    "bairro": "CENTRO",
    "cep": "20031170",
    "uf": "RJ",
    "municipio": "RIO DE JANEIRO",
    "telefone_1": "2121660000",
    "telefone_2": null,
    "email": "[email protected]",
    "qualificacao_responsavel": "Diretor",
    "ente_federativo": null
  }
}

Campos da resposta

Campo	Tipo	Descricao
cnpj	string	CNPJ completo (14 caracteres)
cnpj_basico	string	Primeiros 8 caracteres (raiz)
cnpj_ordem	string	4 caracteres de ordem do estabelecimento
cnpj_dv	string	2 dígitos verificadores numéricos
razao_social	string	Razao social da empresa
nome_fantasia	string?	Nome fantasia, se houver
natureza_juridica	string?	Descricao da natureza juridica
capital_social	string?	Capital social (decimal com 2 casas)
porte_empresa	string?	Porte da empresa (Nao informado, Microempresa, Empresa de Pequeno Porte, Demais)
situacao_cadastral	string	Situacao cadastral (Nula, Ativa, Suspensa, Inapta, Baixada)
data_situacao_cadastral	date?	Data da situacao cadastral (YYYY-MM-DD)
motivo_situacao_cadastral	string?	Descricao do motivo da situacao cadastral
data_inicio_atividade	date?	Data de inicio da atividade (YYYY-MM-DD)
cnae_fiscal_principal	string?	Descricao da atividade economica principal (CNAE)
cnae_fiscal_secundaria	string?	CNAEs secundarios separados por virgula
tipo_logradouro	string?	Tipo do logradouro (RUA, AV, etc.)
logradouro	string?	Nome do logradouro
numero	string?	Numero do endereco
complemento	string?	Complemento do endereco
bairro	string?	Bairro
cep	string?	CEP (8 digitos)
uf	string?	Unidade federativa (sigla)
municipio	string?	Nome do municipio
telefone_1	string?	Telefone principal (DDD + numero)
telefone_2	string?	Telefone secundario
email	string?	E-mail de contato
qualificacao_responsavel	string?	Descricao da qualificacao do responsavel
ente_federativo	string?	Ente federativo responsavel, se aplicavel

Erros

401

Chave de API invalida ou ausente {"message": "Chave de API inválida ou ausente."}

422

CNPJ com formato inválido {"message": "O CNPJ deve conter 12 caracteres alfanuméricos e 2 dígitos verificadores."}

404

CNPJ nao encontrado na base {"message": "CNPJ 99.154.252/0001-32 não encontrado."}