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

Registros importados

Mensal

Frequencia de atualizacao

Receita Federal

Fonte oficial dos dados

Quick Start

CNPJ:

bashcurl -H "X-API-Key: SUA_CHAVE" \
     https://cnpj.pertadigital.com/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://cnpj.pertadigital.com/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."}