fontezadocs
Ver todas as páginas
.mdAbrir no ClaudeAbrir no ChatGPT

Obter o cadastro de uma empresa

GET/v1/empresas/{cnpj}X-Api-Key

Cadastro completo de um estabelecimento e o quadro de sócios da empresa (raiz do CNPJ), na competência RFB publicada. Inclui estabelecimentos em qualquer situação cadastral. Os campos preservam os códigos e formatos da Receita Federal: datas em AAAAMMDD e capital social com vírgula decimal.

Parâmetros

  • cnpjstring · caminhoobrigatório

    CNPJ completo com 14 caracteres. Pontos e hífen são removidos e letras viram maiúsculas (CNPJ alfanumérico); a barra não é aceita no caminho e resulta em 404. Os dígitos verificadores não são conferidos.

    Ao menos 14 caracteres.

Resposta

Cadastro e sócios.

  • dataobjeto
    • cnpjstring

      CNPJ completo com 14 caracteres.

    • cnpj_basicostring

      Raiz do CNPJ (8 primeiros caracteres), comum a matriz e filiais.

    • razao_socialstring | null
    • nome_fantasiastring | null
    • matriz_filialstring | null

      1 matriz, 2 filial.

    • situacao_cadastralstring | null

      Código RFB: 01 nula, 02 ativa, 03 suspensa, 04 inapta, 08 baixada.

    • data_inicio_atividadestring | null

      Data no formato RFB AAAAMMDD.

    • cnae_principalstring | null

      Código CNAE de sete dígitos.

    • cnae_principal_descstring | null
    • municipiostring | null
    • ufstring | null
    • cepstring | null

      Oito dígitos, sem hífen.

    • telefonestring | null

      DDD e número do primeiro telefone cadastral, sem formatação; vazio quando ausente.

    • emailstring | null

      E-mail cadastral declarado à RFB.

    • natureza_juridicastring | null

      Descrição da natureza jurídica.

    • portestring | null

      00 não informado, 01 microempresa, 03 empresa de pequeno porte, 05 demais.

    • capital_socialstring | null

      Valor em reais no formato RFB, com vírgula decimal (ex. 150000,00).

    • opcao_simplesstring | null

      S ou N.

    • opcao_meistring | null

      S ou N.

    • qtde_sociosinteger | null
    • sociosarray de objeto
      • nomestring | null
      • cpf_mascaradostring | null

        Documento do sócio como publicado pela RFB: CPF mascarado para pessoa física, CNPJ para pessoa jurídica.

      • qualificacaostring | null

        Código RFB da qualificação do sócio (ex. 49 sócio-administrador).

      • desdestring | null

        Data de entrada na sociedade, formato AAAAMMDD.

  • metaobjeto
    • fontearray de string
    • competenciastring | nullopcional
    • snapshot_idstring | nullopcional

Erros

StatusQuandoCódigo
401Chave ausente, inválida ou revogada.
404Registro não encontrado.
422Parâmetro inválido.
429Cota diária da chave atingida (1.000 chamadas por padrão). Toda requisição autenticada conta, inclusive as que terminam em erro e as recusadas por cota. A contagem renova na virada do dia da base. A resposta não traz Retry-After.
503Autenticação indisponível, base indisponível, consulta interrompida pelo tempo limite (consulta_demorada) ou, nas buscas, consultas demais do mesmo tipo em andamento (api_sobrecarregada).base_indisponivel api_sobrecarregada consulta_demorada

Formatos de erro em Erros; o que conta na cota em Autenticação e cota.