Consultar CNPJ

curl "https://api.cnpj-api.com/v1/cnpj/12345678000195?token=SEU_TOKEN"

curl "https://api.cnpj-api.com/v1/cnpj/12345678000195?token=SEU_TOKEN&formato=receitaws"

{
  "cnpj": "12345678000195",
  "razao_social": "ALFA COMERCIO DIGITAL LTDA",
  "nome_fantasia": "ALFA DIGITAL",
  "data_abertura": "2020-06-05",
  "matriz": true,
  "mei": false,
  "atualizado_em": "2026-09-01T03:12:45.000Z",
  "logo": null,
  "icone": null,
  "websites": null,
  "situacao": {
    "codigo": 2,
    "descricao": "Ativa"
  },
  "data_situacao": "2020-06-05",
  "situacao_especial": null,
  "data_situacao_especial": null,
  "telefones": [
    {
      "tipo": "PRINCIPAL",
      "ddd": "11",
      "numero": "32145678"
    }
  ],
  "emails": ["[email protected]"],
  "atividade_principal": {
    "codigo": 6311900,
    "descricao": "Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na internet"
  },
  "atividades_secundarias": [
    {
      "codigo": 6201501,
      "descricao": "Desenvolvimento de programas de computador sob encomenda"
    }
  ],
  "endereco": {
    "municipio_codigo": 7107,
    "tipo_logradouro": "AVENIDA",
    "logradouro": "BRIGADEIRO FARIA LIMA",
    "numero": "2369",
    "complemento": "CONJ 1102",
    "bairro": "JARDIM PAULISTANO",
    "cep": "01452922",
    "uf": "SP",
    "municipio": "SAO PAULO",
    "pais": {
      "codigo": 105,
      "nome": "BRASIL"
    }
  },
  "empresa": {
    "cnpj_basico": "12345678",
    "capital_social": 50000,
    "natureza_juridica": {
      "codigo": 2062,
      "descricao": "Sociedade Empresária Limitada"
    },
    "porte": {
      "codigo": 1,
      "sigla": "ME",
      "descricao": "Microempresa"
    },
    "simples": {
      "optante": true,
      "data_opcao": "2020-06-05",
      "data_exclusao": null
    },
    "simei": {
      "optante": false,
      "data_opcao": null,
      "data_exclusao": null
    },
    "socios": [
      {
        "data_entrada": "2020-06-05",
        "pessoa": {
          "id": "175f7cfb723ddf80cb5b7feebb0f80eb",
          "tipo": "PESSOA_FISICA",
          "nome": "MARIA OLIVEIRA",
          "cpf_cnpj": "***123456**",
          "faixa_etaria": "31-40"
        },
        "qualificacao": {
          "codigo": 49,
          "descricao": "Sócio-Administrador"
        }
      }
    ]
  }
}

GET

cnpj

{cnpj}

curl "https://api.cnpj-api.com/v1/cnpj/12345678000195?token=SEU_TOKEN"

curl "https://api.cnpj-api.com/v1/cnpj/12345678000195?token=SEU_TOKEN&formato=receitaws"

{
  "cnpj": "12345678000195",
  "razao_social": "ALFA COMERCIO DIGITAL LTDA",
  "nome_fantasia": "ALFA DIGITAL",
  "data_abertura": "2020-06-05",
  "matriz": true,
  "mei": false,
  "atualizado_em": "2026-09-01T03:12:45.000Z",
  "logo": null,
  "icone": null,
  "websites": null,
  "situacao": {
    "codigo": 2,
    "descricao": "Ativa"
  },
  "data_situacao": "2020-06-05",
  "situacao_especial": null,
  "data_situacao_especial": null,
  "telefones": [
    {
      "tipo": "PRINCIPAL",
      "ddd": "11",
      "numero": "32145678"
    }
  ],
  "emails": ["[email protected]"],
  "atividade_principal": {
    "codigo": 6311900,
    "descricao": "Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na internet"
  },
  "atividades_secundarias": [
    {
      "codigo": 6201501,
      "descricao": "Desenvolvimento de programas de computador sob encomenda"
    }
  ],
  "endereco": {
    "municipio_codigo": 7107,
    "tipo_logradouro": "AVENIDA",
    "logradouro": "BRIGADEIRO FARIA LIMA",
    "numero": "2369",
    "complemento": "CONJ 1102",
    "bairro": "JARDIM PAULISTANO",
    "cep": "01452922",
    "uf": "SP",
    "municipio": "SAO PAULO",
    "pais": {
      "codigo": 105,
      "nome": "BRASIL"
    }
  },
  "empresa": {
    "cnpj_basico": "12345678",
    "capital_social": 50000,
    "natureza_juridica": {
      "codigo": 2062,
      "descricao": "Sociedade Empresária Limitada"
    },
    "porte": {
      "codigo": 1,
      "sigla": "ME",
      "descricao": "Microempresa"
    },
    "simples": {
      "optante": true,
      "data_opcao": "2020-06-05",
      "data_exclusao": null
    },
    "simei": {
      "optante": false,
      "data_opcao": null,
      "data_exclusao": null
    },
    "socios": [
      {
        "data_entrada": "2020-06-05",
        "pessoa": {
          "id": "175f7cfb723ddf80cb5b7feebb0f80eb",
          "tipo": "PESSOA_FISICA",
          "nome": "MARIA OLIVEIRA",
          "cpf_cnpj": "***123456**",
          "faixa_etaria": "31-40"
        },
        "qualificacao": {
          "codigo": 49,
          "descricao": "Sócio-Administrador"
        }
      }
    ]
  }
}

string

obrigatório

Número do CNPJ sem pontuação (14 caracteres). Exemplo: 12345678000195. Aceita também o formato alfanumérico vigente desde julho de 2026, em que as 12 primeiras posições podem conter letras: 00000000E08G12. Letras minúsculas são normalizadas.

string

Token de autenticação. Forma preferida de autenticação.

string

padrão:"default"

Formato de resposta para compatibilidade com outras APIs:

default: Formato nativo desta API (padrão)
receitaws: Compatível com a ReceitaWS
cnpja: Compatível com a CNPJa

Fontes de dados

Dados atualizados mensalmente com base nos arquivos públicos da Receita Federal. Limitado a 5 consultas por minuto para tokens gratuitos. Veja Limites de Uso.

Resposta

Os campos abaixo descrevem o formato default, retornado quando formato é omitido. Com formato=receitaws ou formato=cnpja, a resposta segue o formato da respectiva API: veja Migrar da ReceitaWS e Migrar da CNPJa.

string

Número do CNPJ sem pontuação (14 caracteres), em maiúsculas.

Razão social da empresa.

string

Nome fantasia do estabelecimento. Omitido quando a Receita Federal não informa um.

string

Data de abertura do estabelecimento (AAAA-MM-DD).

boolean

true para a matriz, false para filiais.

boolean

true quando a empresa está enquadrada no MEI (optante pelo SIMEI). Sempre presente; false quando a empresa nunca optou pelo Simples Nacional. Mesmo valor de empresa.simei.optante.

string

Data e hora (ISO 8601) da última atualização dos dados.

null

Sempre null neste endpoint. Use Logos e Sites para obter o logotipo.

null

Sempre null neste endpoint. Use Logos e Sites para obter o favicon.

null

Sempre null neste endpoint. Use Logos e Sites para obter os sites da empresa.

object

Situação cadastral do estabelecimento.

Mostrar propriedades

number

1 Nula, 2 Ativa, 3 Suspensa, 4 Inapta, 8 Baixada.

string

Descrição da situação, por exemplo Ativa.

string

Data da situação cadastral atual (AAAA-MM-DD).

object

Motivo da situação cadastral. Presente apenas quando a situação não é Ativa e a Receita Federal informa um motivo.

Mostrar propriedades

number

Código do motivo na tabela da Receita Federal.

string

Descrição do motivo, por exemplo EXTINCAO POR ENCERRAMENTO LIQUIDACAO VOLUNTARIA.

string | null

Situação especial, por exemplo recuperação judicial. null quando não há.

string | null

Data da situação especial (AAAA-MM-DD). null quando não há.

object[]

Telefones cadastrados. Lista vazia quando não há.

Mostrar propriedades

string

PRINCIPAL, SECUNDARIO ou FAX.

string

Código de área.

string

Número do telefone, sem o DDD.

string[]

E-mails cadastrados, em minúsculas. Lista vazia quando não há.

object

Atividade econômica principal (CNAE).

Mostrar propriedades

number

Código CNAE de 7 dígitos, sem pontuação.

string

Descrição da atividade.

object[]

Atividades econômicas secundárias, no mesmo formato de atividade_principal. Lista vazia quando não há.

object

Endereço do estabelecimento. Os textos vêm como a Receita Federal publica: em maiúsculas e sem acentos.

Mostrar propriedades

number

Código do município na tabela da Receita Federal (TOM). Não é o código IBGE.

string

Tipo do logradouro, por exemplo RUA ou AVENIDA.

string

Nome do logradouro, sem o tipo.

string

Número. Pode ser um texto como S/N.

string

Complemento. Texto vazio quando não há.

string

Bairro.

string

CEP com 8 dígitos, sem pontuação.

string

Sigla do estado.

string

Nome do município.

object

País, com codigo (tabela da Receita Federal) e nome.

object

Dados da empresa à qual o estabelecimento pertence. São os mesmos para a matriz e todas as filiais.

Mostrar propriedades

string

Os 8 primeiros dígitos do CNPJ, comuns a todos os estabelecimentos da empresa.

Capital social, em reais.

string

Ente federativo responsável. Presente apenas para órgãos públicos (natureza_juridica.codigo menor que 2000).

object

Natureza jurídica, com codigo (por exemplo 2062) e descricao (por exemplo Sociedade Empresária Limitada).

object

Porte da empresa: codigo (1 ME, 3 EPP, 5 Demais), sigla e descricao.

object

Opção pelo Simples Nacional. Omitido quando a empresa nunca optou.

Mostrar propriedades

boolean

true quando a empresa é optante hoje.

string | null

Data da opção (AAAA-MM-DD).

string | null

Data da exclusão (AAAA-MM-DD). null quando a empresa não foi excluída.

object

Enquadramento no MEI (SIMEI), com os mesmos campos de simples. Omitido quando a empresa nunca optou pelo Simples Nacional.

object[]

Quadro de sócios e administradores (QSA). Lista vazia quando não há.

Mostrar propriedades

string

Data de entrada na sociedade (AAAA-MM-DD).

object

O sócio ou administrador.

Mostrar propriedades

string

Identificador estável da pessoa, gerado a partir do tipo, do CPF/CNPJ e do nome.

string

PESSOA_FISICA, PESSOA_JURIDICA, ESTRANGEIRO ou DESCONHECIDO.

string

Nome ou razão social.

string

CNPJ do sócio, ou CPF mascarado pela Receita Federal (por exemplo ***123456**). Omitido quando não informado.

string

Faixa etária, de 0-12 a 81+. Presente apenas para PESSOA_FISICA.

object

País de origem, com codigo e nome. Presente apenas para ESTRANGEIRO.

object

Qualificação do sócio, com codigo e descricao (por exemplo Sócio-Administrador).

object

Representante legal do sócio, com pessoa e qualificacao no mesmo formato acima. Presente apenas quando a Receita Federal informa um.

curl "https://api.cnpj-api.com/v1/cnpj/12345678000195?token=SEU_TOKEN"

curl "https://api.cnpj-api.com/v1/cnpj/12345678000195?token=SEU_TOKEN&formato=receitaws"

{
  "cnpj": "12345678000195",
  "razao_social": "ALFA COMERCIO DIGITAL LTDA",
  "nome_fantasia": "ALFA DIGITAL",
  "data_abertura": "2020-06-05",
  "matriz": true,
  "mei": false,
  "atualizado_em": "2026-09-01T03:12:45.000Z",
  "logo": null,
  "icone": null,
  "websites": null,
  "situacao": {
    "codigo": 2,
    "descricao": "Ativa"
  },
  "data_situacao": "2020-06-05",
  "situacao_especial": null,
  "data_situacao_especial": null,
  "telefones": [
    {
      "tipo": "PRINCIPAL",
      "ddd": "11",
      "numero": "32145678"
    }
  ],
  "emails": ["[email protected]"],
  "atividade_principal": {
    "codigo": 6311900,
    "descricao": "Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na internet"
  },
  "atividades_secundarias": [
    {
      "codigo": 6201501,
      "descricao": "Desenvolvimento de programas de computador sob encomenda"
    }
  ],
  "endereco": {
    "municipio_codigo": 7107,
    "tipo_logradouro": "AVENIDA",
    "logradouro": "BRIGADEIRO FARIA LIMA",
    "numero": "2369",
    "complemento": "CONJ 1102",
    "bairro": "JARDIM PAULISTANO",
    "cep": "01452922",
    "uf": "SP",
    "municipio": "SAO PAULO",
    "pais": {
      "codigo": 105,
      "nome": "BRASIL"
    }
  },
  "empresa": {
    "cnpj_basico": "12345678",
    "capital_social": 50000,
    "natureza_juridica": {
      "codigo": 2062,
      "descricao": "Sociedade Empresária Limitada"
    },
    "porte": {
      "codigo": 1,
      "sigla": "ME",
      "descricao": "Microempresa"
    },
    "simples": {
      "optante": true,
      "data_opcao": "2020-06-05",
      "data_exclusao": null
    },
    "simei": {
      "optante": false,
      "data_opcao": null,
      "data_exclusao": null
    },
    "socios": [
      {
        "data_entrada": "2020-06-05",
        "pessoa": {
          "id": "175f7cfb723ddf80cb5b7feebb0f80eb",
          "tipo": "PESSOA_FISICA",
          "nome": "MARIA OLIVEIRA",
          "cpf_cnpj": "***123456**",
          "faixa_etaria": "31-40"
        },
        "qualificacao": {
          "codigo": 49,
          "descricao": "Sócio-Administrador"
        }
      }
    ]
  }
}

Introdução

Autenticação

Endpoints

Skill CNPJ

Migração

Suporte

Fontes de dados

Resposta

​Fontes de dados

​Resposta

Fontes de dados

Resposta