Serviços / CNPJ

Cadastro de Pessoa Jurídica

GET/api/v1/cnpj/{cnpj}

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: Receita Federal — dados abertos · mensal

Parâmetros

cnpjstringObrigatório

Com ou sem pontuação. O dígito verificador é conferido antes da consulta.

49670293000103
path

Campos da resposta

Encontrado

found

boolean

CNPJ

cnpj

string

Mês de referência

reference_month

Mês da base da Receita que respondeu.

string

Data de extração

extracted_at

Data em que a Receita extraiu os dados.

string

Razão social

razao_social

string

Nome fantasia

nome_fantasia

string

Natureza jurídica

natureza_juridica

string

Código da natureza jurídica

natureza_juridica_codigo

integer

Porte

porte

string

Capital social

capital_social

number

Matriz

matriz

boolean

Situação cadastral

situacao_cadastral

string

Código da situação

situacao_cadastral_codigo

integer

Data da situação

data_situacao_cadastral

string

Motivo da situação

motivo_situacao_cadastral

string

Início de atividade

data_inicio_atividade

string

Atividade principal (CNAE)

atividade_principal

object

CNAE

atividade_principal.codigo

integer

Descrição do CNAE

atividade_principal.descricao

string

Endereço

endereco

object

Tipo de logradouro

endereco.tipo_logradouro

string

Logradouro

endereco.logradouro

string

Número

endereco.numero

string

Complemento

endereco.complemento

string

Bairro

endereco.bairro

string

CEP

endereco.cep

string

Município

endereco.municipio

string

Código do município

endereco.municipio_codigo

integer

UF

endereco.uf

string

E-mail

email

string

Telefone

telefone

string

Simples / MEI

simples

object

Optante do Simples

simples.optante_simples

boolean

Entrada no Simples

simples.data_opcao_simples

string

Saída do Simples

simples.data_exclusao_simples

string

MEI

simples.optante_mei

boolean

Entrada no MEI

simples.data_opcao_mei

string

Saída do MEI

simples.data_exclusao_mei

string

Exemplo de resposta

Modelo de resposta: CnpjOutput
JSON · response
{
  "success": true,
  "code": 200,
  "code_message": "A requisição foi processada com sucesso.",
  "errors": [],
  "header": null,
  "data_count": 1,
  "data": [
    {
      "found": true,
      "cnpj": "49670293000103",
      "reference_month": "2026-07",
      "extracted_at": null,
      "razao_social": "COIN NODES LTDA",
      "nome_fantasia": "COIN NODES",
      "natureza_juridica": "Sociedade Empresária Limitada",
      "natureza_juridica_codigo": null,
      "porte": "Demais",
      "capital_social": 100000,
      "matriz": true,
      "situacao_cadastral": "Ativa",
      "situacao_cadastral_codigo": 2,
      "data_situacao_cadastral": null,
      "motivo_situacao_cadastral": null,
      "data_inicio_atividade": null,
      "atividade_principal": {
        "codigo": 6201501,
        "descricao": "Desenvolvimento de programas de computador sob encomenda"
      },
      "endereco": {
        "tipo_logradouro": null,
        "logradouro": "AVENIDA PAULISTA",
        "numero": "1000",
        "complemento": null,
        "bairro": "BELA VISTA",
        "cep": "01310100",
        "municipio": "SAO PAULO",
        "municipio_codigo": null,
        "uf": "SP"
      },
      "email": null,
      "telefone": null,
      "simples": {
        "optante_simples": false,
        "data_opcao_simples": null,
        "data_exclusao_simples": null,
        "optante_mei": false,
        "data_opcao_mei": null,
        "data_exclusao_mei": null
      }
    }
  ]
}

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.