---
title: "Consultar os dados cadastrais de um CNPJ"
method: GET
path: "/v1/cnpj/{cnpj}"
tags: ["Consulta"]
---

# Consultar os dados cadastrais de um CNPJ

`GET /v1/cnpj/{cnpj}`

## Request

- Base URL: `https://apipj.com.br`
- URL: `https://apipj.com.br/v1/cnpj/{cnpj}`
- Auth: HTTP bearer

Devolve o documento cadastral de um CNPJ a partir dos dados abertos da Receita Federal (atualizados uma vez por mês; o campo `atualizado_em` traz o mês do lote). Exige chave de API: `Authorization: Bearer apipj_live_...` (conta grátis em /criar-conta). Cada consulta respondida, inclusive 404, conta 1 na cota mensal do plano; também vale um limite por minuto por chave. Formato `completo` (padrão: objetos aninhados, datas ISO e códigos da Receita) ou `simplificado` (formato plano com campos já formatados). Aceita CNPJ numérico ou alfanumérico, com ou sem pontuação.

## Path parameters

- `cnpj` string, required

## Query parameters

- `formato` 'completo' | 'simplificado'

## Response `200`

Documento cadastral do CNPJ

- union
  - DocumentoCompleto: Formato `completo` (padrão). Campos ausentes na base da Receita vêm como `null`; nenhuma chave some.
    - `cnpj` string, required: 14 caracteres, sem pontuação
    - `cnpj_formatado` string, required: AA.AAA.AAA/AAAA-DD
    - `razao_social` string, required: Razão social
    - `nome_fantasia` string, nullable: Nome fantasia
    - `matriz_filial` string: MATRIZ ou FILIAL
    - `situacao_cadastral` object, required
      - `codigo` string, nullable: Código
      - `descricao` string, nullable: ATIVA, BAIXADA, INAPTA, SUSPENSA ou NULA
      - `data` string, date, nullable: Data da situação (AAAA-MM-DD)
      - `motivo` CodigoDescricao
        - `codigo` string, nullable: Código da Receita Federal
        - `descricao` string, nullable: Descrição
    - `situacao_especial` object
      - `descricao` string, nullable: Situação especial
      - `data` string, date, nullable: Data da situação especial (AAAA-MM-DD)
    - `data_inicio_atividade` string, date, nullable: Início da atividade (AAAA-MM-DD)
    - `natureza_juridica` CodigoDescricao
      - `codigo` string, nullable: Código da Receita Federal
      - `descricao` string, nullable: Descrição
    - `qualificacao_responsavel` CodigoDescricao
      - `codigo` string, nullable: Código da Receita Federal
      - `descricao` string, nullable: Descrição
    - `porte` CodigoDescricao
      - `codigo` string, nullable: Código da Receita Federal
      - `descricao` string, nullable: Descrição
    - `capital_social` number, nullable: Capital social em reais
    - `cnae_principal` CodigoDescricao
      - `codigo` string, nullable: Código da Receita Federal
      - `descricao` string, nullable: Descrição
    - `cnaes_secundarios` CodigoDescricao[]
      - `codigo` string, nullable: Código da Receita Federal
      - `descricao` string, nullable: Descrição
    - `endereco` object
      - `tipo_logradouro` string, nullable: RUA, AVENIDA…
      - `logradouro` string, nullable: Logradouro
      - `numero` string, nullable: Número
      - `complemento` string, nullable: Complemento
      - `bairro` string, nullable: Bairro
      - `cep` string, nullable: CEP, só dígitos
      - `municipio` object
        - `codigo_rfb` string, nullable: Código do município na Receita
        - `codigo_ibge` string, nullable: Código IBGE (7 dígitos)
        - `nome` string, nullable: Nome
      - `uf` string, nullable: UF
      - `pais` string, nullable: País (endereço no exterior)
      - `cidade_exterior` string, nullable: Cidade no exterior
    - `telefones` Telefone[]
      - `ddd` string, nullable: DDD
      - `numero` string, nullable: Número, só dígitos
    - `fax` Telefone
      - `ddd` string, nullable: DDD
      - `numero` string, nullable: Número, só dígitos
    - `email` string, nullable: E-mail informado à Receita
    - `ente_federativo_responsavel` string, nullable: Ente federativo responsável (administração pública)
    - `simples` OpcaoRegime
      - `optante` boolean
      - `data_opcao` string, date, nullable: Data da opção (AAAA-MM-DD)
      - `data_exclusao` string, date, nullable: Data da exclusão (AAAA-MM-DD)
    - `mei` OpcaoRegime
      - `optante` boolean
      - `data_opcao` string, date, nullable: Data da opção (AAAA-MM-DD)
      - `data_exclusao` string, date, nullable: Data da exclusão (AAAA-MM-DD)
    - `socios` Socio[]
      - `nome` string, nullable: Nome do sócio
      - `tipo` string, nullable: PESSOA FISICA, PESSOA JURIDICA ou ESTRANGEIRO
      - `cpf_cnpj` string, nullable: CPF já mascarado pela Receita (***123456**) ou raiz de 8 caracteres do CNPJ do sócio pessoa jurídica
      - `qualificacao` CodigoDescricao
        - `codigo` string, nullable: Código da Receita Federal
        - `descricao` string, nullable: Descrição
      - `data_entrada` string, date, nullable: Entrada na sociedade (AAAA-MM-DD)
      - `faixa_etaria` string, nullable: Faixa etária
      - `pais` string, nullable: País (sócio estrangeiro)
      - `representante_legal` object, nullable
        - `cpf` string, nullable: CPF mascarado
        - `nome` string, nullable: Nome
        - `qualificacao` CodigoDescricao
          - `codigo` string, nullable: Código da Receita Federal
          - `descricao` string, nullable: Descrição
    - `atualizado_em` string, required: Mês do lote da Receita Federal (AAAA-MM)
  - DocumentoSimplificado: Formato `simplificado`: plano, com datas DD/MM/AAAA, CNPJ, CEP e telefone já formatados e vazios como "".
    - `abertura` string
    - `situacao` string
    - `tipo` string
    - `nome` string
    - `fantasia` string
    - `porte` string
    - `natureza_juridica` string
    - `atividade_principal` unknown[]
      - unknown
    - `atividades_secundarias` unknown[]
      - unknown
    - `qsa` unknown[]
      - unknown
    - `logradouro` string
    - `numero` string
    - `complemento` string
    - `municipio` string
    - `bairro` string
    - `uf` string
    - `cep` string
    - `email` string
    - `telefone` string
    - `data_situacao` string
    - `cnpj` string
    - `ultima_atualizacao` string
    - `status` string
    - `efr` string
    - `motivo_situacao` string
    - `situacao_especial` string
    - `data_situacao_especial` string
    - `capital_social` string
    - `simples` object
    - `simei` object
    - `extra` object
    - `billing` object

## Other responses

- `400`: CNPJ inválido (`invalid_cnpj`) ou parâmetro fora do contrato (`validation_error`)
- `401`: Sem chave de API, ou chave inválida ou revogada (`unauthorized`)
- `404`: CNPJ válido, mas ausente da base da Receita Federal (`not_found`)
- `429`: Limite por minuto (`rate_limited`, com `Retry-After`) ou cota mensal (`quota_exceeded`, com `upgrade_url`) excedidos
- `503`: Base de CNPJ indisponível no momento (`dataset_unavailable`)

---

[API](https://skmtc.dev/apipj/apis/apipj-api-de-cnpj.md) · [All operations](https://skmtc.dev/apipj/apis/apipj-api-de-cnpj/llms.txt) · [OpenAPI document](https://skmtc.dev/apipj/apis/apipj-api-de-cnpj/revisions/3896b833e2b5?raw)