Documentação API - CPF.CNPJ

Sobre

API para consulta de CPF na Receita Federal, permitindo integração ágil, sem captcha ou data de nascimento. Assim, você obtém dados de pessoas e de empresas em tempo real, reduzindo fraudes e garantindo a confiabilidade dos cadastros em suas aplicações.

Além disso, nossa API para consulta de CPF e CNPJ tem tempo médio de resposta abaixo de 1 segundo, viabilizando a automatização de processos e a manutenção de um banco de dados completo e seguro.
Conheça mais em nosso site.

Certificações

Em 2025, obtivemos três certificações ISO/IEC de destaque que comprovam nosso compromisso com a privacidade, a segurança da informação e o cumprimento da legislação:

• Information Security Management 27001:2022 (Certificado Q7LUQTCU20251113BRAIS1Z1): certifica nosso Sistema de Gestão de Segurança da Informação, garantindo a confidencialidade, integridade e disponibilidade dos dados.
• Privacy Information Management 27701:2025 (Certificado Q7LUQTCU20251113BRAPI15R): atesta nossa conformidade com as melhores práticas de gestão de privacidade da informação, incluindo LGPD e GDPR.
• Compliance Management System 37301:2021 (Certificado Q7LUQTCC20251113BRACM1X7): comprova nossa adesão a um sistema de gestão de compliance robusto, assegurando o cumprimento de normas e regulamentações.

Para saber mais sobre nossos processos e políticas, consulte:

• Lei Geral de Proteção de Dados (LGPD)
• Segurança e Conformidade
• Políticas de Privacidade
• Termos de Uso

Veracidade e Atualização dos Dados

Disponibilizamos apenas dados atualizados em tempo real (D+0) com 100% de cobertura dos documentos consultados. Assim, qualquer alteração cadastral do titular é refletida exatamente conforme consta na Receita Federal. Ao contrário de muitos provedores do mercado, não utilizamos bases antigas, incompletas ou vazadas, o que nos permite garantir cobertura integral para todos os documentos consultados.

Para mais informações, acesse: www.cpfcnpj.com.br

Introdução

Este documento apresenta as diretrizes para integrar rapidamente aos serviços da CPF.CNPJ via HTTP (HTTP API).
Qualquer linguagem de programação é compatível com nossa solução.

Regras e Limites de Uso

Para evitar o uso indevido da API e manter sua alta disponibilidade, estabelecemos as seguintes restrições:

• Após 3 consultas consecutivas com Token inválido: bloqueio de 5 minutos;
• Após 3 consultas consecutivas do mesmo CPF/CNPJ no mesmo pacote em menos de 1 minuto: bloqueio de 3 minutos;
• Após 3 consultas consecutivas sem créditos em menos de 1 minuto: bloqueio de 5 minutos.

Há ainda um limite de 20 requisições por segundo. Caso esse limite seja atingido, aguarde o próximo segundo e tente novamente. Se necessário, você pode solicitar o aumento desse limite diretamente com o suporte técnico.

URL Base

As requisições GET são feitas em uma URL base sob protocolo HTTPS.

URL: https://api.cpfcnpj.com.br/

Firewall

Certifique-se de conceder permissões em seu firewall para os IPs da CloudFlare.

Acesse a lista de IPs para liberação: https://www.cloudflare.com/ips/

Content-Type

O retorno de dados da API será via JSON.

Timeout

Use o timeout padrão de 60 segundos. Caso utilize um valor inferior, em uma instabilidade da API poderá ocorrer de sua requisição ser abortada antes de receber a resposta, consumindo créditos.

Atualmente, a média de retorno das consultas está em 2 segundos.

Tokens

Para realizar consultas, será necessário gerar o token de integração. Para isso, acesse a opção API > Tokens em seu Painel de Controle. Após o cadastro, seu token será gerado para que seja inserido na URL da requisição.

IDs dos Pacotes

Em cada requisição, será necessário informar na URL o ID do Pacote desejado, aqui nomeado de {pacote}.

Para contratar os pacotes desejados, acesse o Painel de Controle. Consulte-os em nosso site.

Realizando Consultas

Em poucas etapas, explicaremos como a consulta é feita pela API da CPF.CNPJ.

Após gerar o token, conforme Introdução, será necessário montar a URL da requisição.

Definição

Endpoint que conterá o Token, ID do Pacote e número do CPF ou CNPJ a ser consultado, respectivamente.

Parâmetros da Requisição

Exemplos de URL:

Consultar CPF no pacote CPF E: https://api.cpfcnpj.com.br/5ae973d7a997af13f0aaf2bf60e65803/9/00000000000

Consultar CNPJ no pacote CNPJ D: https://api.cpfcnpj.com.br/5ae973d7a997af13f0aaf2bf60e65803/6/27272134000118

Consultar lista de empresas a partir da Razão Social no pacote CNPJ A: https://api.cpfcnpj.com.br/5ae973d7a997af13f0aaf2bf60e65803/4?razao_social=GOOGLE BRASIL

Parâmetros das Respostas

Confira abaixo os campos retornados para CPFs e CNPJs.

Cada pacote de consultas possui seus respectivos parâmetros de respostas. Sendo assim, integre de acordo.

Respostas CPFs

Objeto principal da resposta que varia de acordo com o pacote:

Objeto cac

Objeto cac{} contendo os dados da Certidão de Antecedentes Criminais (SINIC) emitida pela Polícia Federal. Retornado no Pacote CPF CAC/SINIC (27).

Array PPE

Array ppe[] contendo lista de cargos da PPE/PEP:

Array relacionados (PPE)

Array relacionados[] contendo familiares próximos do titular que possuem cargo PPE. Retornado no Pacote CPF PPE (14).

Array empresas

Array empresas[] contendo empresas em que o CPF é sócio ou administrador. Retornado no Pacote CPF Empresas (15).

Array programasSociais

Array programasSociais[] contendo benefícios sociais ativos para o CPF. Retornado no Pacote CPF Programas Sociais (22).

Array mandados (BNMP)

Array mandados[] contendo mandados de prisão registrados no Banco Nacional de Mandados de Prisão (BNMP/CNJ). Retornado nos Pacotes CPF BNMP (20) e CPF Antecedentes Criminais (23).

Array interpol

Array interpol[] contendo alertas vermelhos/amarelos da Interpol. Retornado no Pacote CPF Antecedentes Criminais (23).

Objeto arrestWarrant (interpol)

Objeto interno de cada item de interpol[].arrestWarrants[].

Objeto nacionalidade

Objeto nacionalidade{} com a nacionalidade declarada do CPF.

Array enderecos (PF)

Array enderecos[] com endereços adicionais conhecidos do CPF. O endereço principal já vem nos campos endereco, numero, cep, etc. da raiz da resposta.

Array telefones (PF)

Array telefones[] de strings (telefones em formato E.164 sem o sinal de mais ou apenas DDD+número, dependendo da fonte). Exemplo: ["11999999999","3188888888"].

Array whatsapp (PF)

Array whatsapp[] de strings com números de telefone que possuem WhatsApp ativo confirmado. Subconjunto de telefones[].

Array emails (PF)

Array emails[] de strings com endereços de e-mail conhecidos do CPF.

Respostas CNPJs

Objeto principal da resposta que varia de acordo com o pacote:

Objeto simplesNacional

Objeto simplesNacional{} contendo informações de Simples Nacional:

Objeto simei

Objeto simei{} contendo informações de SIMEI (Sistema de Recolhimento em Valores Fixos Mensais dos Tributos abrangidos pelo Simples Nacional, exclusivo para MEI):

Array anteriores

Array anteriores[] com registros históricos de adesão e saída do regime tributário (Simples Nacional ou SIMEI). Cada item descreve um período em que a empresa esteve enquadrada anteriormente.

Objeto matrizEndereco

Objeto matrizfilial

Informações sobre o órgão competente (matriz ou filial):

Array telefones

Objeto fax

Objeto situacao

Objeto situacao{} com dados da situação cadastral da empresa.

Pacote 6: Situação cadastral obtida em tempo real diretamente da Receita Federal, garantindo dados sempre atualizados.

Objeto motivo (situacao)

Objeto interno de situacao.motivo{} descrevendo o motivo da situação cadastral.

Objeto naturezaJuridica

Objeto naturezaJuridica{} com dados da natureza jurídica.
Lista oficial

Objeto cnae

Objeto cnae{} com dados do CNAE principal.
Tabela CNAE

Array secundarias (cnae)

Array secundarias[] de objetos representando os CNAEs secundários cadastrados.

Objeto porte

Objeto porte{} contendo dados do porte da empresa.

Array socios

Array socios[] contendo dados do QSA (Quadro de Sócios e Administradores):

Pacote 25 (CNPJ Percentual Societário): estrutura reduzida contendo apenas cpf_cnpj_socio, nome, qualificacao_socio (string), data_entrada (formato DD/MM/AAAA) e percentual. Os demais pacotes CNPJ retornam a estrutura completa abaixo, com data_entrada em formato YYYY-MM-DD e qualificacao_socio como objeto.

Objeto dispensa

Objeto dispensa{} contendo informações sobre dispensa de licenciamento e autorizações. Disponível apenas no pacote 6, obtido em tempo real da Receita Federal.

Array condicoes (dispensa)

Array de objetos contendo as condições de dispensa por órgão:

Objeto ibge

Objeto ibge{} com os identificadores oficiais (IBGE/SIAFI) de país, estado e cidade do endereço. Retornado em respostas de CNPJ.

Objeto pais

Objeto pais{} com identificadores do país.

Objeto estado

Objeto estado{} com identificadores do estado.

Objeto cidade

Objeto cidade{} com identificadores da cidade.

Objeto qualificacao

Estrutura comum reutilizada nos campos responsavelQualificacao, qualificacao_socio, qualificacao_representante e situacao.motivo.

Array inscricoesEstaduais

Array inscricoesEstaduais[] com todas as inscrições estaduais conhecidas da empresa em cada UF, ativas ou inativas. Disponível no Pacote 16.

Array inscricoesSuframa

Array inscricoesSuframa[] com inscrições SUFRAMA da empresa, quando aplicável.

Array regimesTributarios

Array regimesTributarios[] com o histórico do regime tributário declarado por ano-calendário.

Exemplos de Resposta por Pacote

Todos os exemplos abaixo refletem o JSON retornado pelo Token de Testes 5ae973d7a997af13f0aaf2bf60e65803. Em produção, os dados são reais e os campos opcionais podem variar.

Pacote 1, 2, 3, 7, 8, 9, 17, 18 — CPF Completo / RF / Simples

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "nascimento": "31/12/1900",
  "telefones": ["11999999999", "3188888888"],
  "whatsapp": ["11999999999"],
  "emails": ["[email protected]", "[email protected]"],
  "endereco": "Rua A",
  "numero": "100 B",
  "complemento": "Apto 03",
  "bairro": "Centro",
  "cep": "99999123",
  "cidade": "Sao Paulo",
  "uf": "SP",
  "ibge": "1234567",
  "mae": "Maria Jose",
  "genero": "M",
  "enderecos": [
    {"endereco": "Rua A", "numero": "100 B", "complemento": "Apto 03", "bairro": "Centro", "cep": "99999123", "cidade": "Sao Paulo", "uf": "SP", "ibge": "1234567"},
    {"endereco": "Rua B", "numero": "200 B", "complemento": "Apto 10", "bairro": "Centro", "cep": "99999123", "cidade": "Sao Paulo", "uf": "SP", "ibge": "1234567"}
  ],
  "nacionalidade": {"idPais": 76, "paisOrigem": "Brasil"},
  "situacaoInscricao": "anterior a 10/11/1990",
  "situacao": "Cancelada",
  "situacaoDigito": "03",
  "situacaoMotivo": "TITULAR FALECIDO",
  "situacaoAnoObito": 2015,
  "situacaoComprovante": "1A1A.2B2B.3C3C.4D4D",
  "situacaoComprovanteEmissao": "01/01/2025 12:00:00",
  "situacaoComprovantePdf": "base64",
  "pacoteUsado": 1,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 4 — Pesquisa por Razão Social

Endpoint: https://api.cpfcnpj.com.br/{token}/4/?rzsocial=GOOGLE BRASIL

{
  "status": 1,
  "razao": "TOKEN TEST",
  "resultado": ["11222333000181", "44555666000199", "77888999000110"],
  "pacoteUsado": 4,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 4, 5, 6, 10, 11, 16, 19 — CNPJ Completo / RF / WS / IE

{
  "status": 1,
  "cnpj": "11.222.333/0001-81",
  "tipo": "Matriz",
  "razao": "TOKEN TEST LTDA",
  "fantasia": "TOKEN TEST",
  "capitalSocial": 95000,
  "inicioAtividade": "31/12/1999",
  "email": "[email protected]",
  "responsavel": "Joao Jose",
  "responsavelCpf": "111.222.333-44",
  "responsavelQualificacao": {"id": 49, "descricao": "Sócio-Administrador"},
  "simplesNacional": {"optante": "Não", "inicio": "17/01/2020", "fim": "01/01/2023"},
  "simei": {"optante": "Sim", "inicio": "17/01/2023", "fim": null},
  "matrizEndereco": {"cep": "0000-111", "tipo": "Rua", "logradouro": "Rua A", "numero": "1", "complemento": "Sala 1", "bairro": "Centro", "cidade": "Montes Claros", "uf": "MG"},
  "matrizfilial": {"id": 1, "tipo": "Matriz"},
  "telefones": [{"ddd": "11", "numero": "22334454"}],
  "fax": {"ddd": "11", "numero": "22334455"},
  "situacao": {"id": 4, "nome": "Inapta", "data": "03/04/2020", "motivo": {"id": 63, "descricao": "Omissão De Declarações"}},
  "naturezaJuridica": {"codigo": "2062", "descricao": "Sociedade Empresaria Limitada"},
  "cnae": {"fiscal": "6202300", "secao": "J", "divisao": "62", "grupo": "62.0", "classe": "62.02-3", "subClasse": "6202-3/00", "descricao": "Desenvolvimento e licenciamento de programas de computador customizáveis", "secundarias": []},
  "porte": {"id": "03", "descricao": "Empresa de Pequeno Porte"},
  "socios": [
    {"cpf_cnpj_socio": "111.222.333-44", "nome": "Joao Jose", "tipo": "Pessoa Física", "data_entrada": "2020-01-01", "qualificacao_socio": {"id": 49, "descricao": "Sócio-Administrador"}, "pais": {"id": "1058", "iso2": "BR", "iso3": "BRA", "nome": "Brasil"}}
  ],
  "inscricoesEstaduais": [
    {"inscricao_estadual": "0010101010101", "ativo": true, "atualizado_em": "2023-10-03T03:00:00.000Z", "estado": {"id": 11, "nome": "Minas Gerais", "sigla": "MG", "ibge_id": 31}}
  ],
  "pacoteUsado": 6,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 12 — CNPJ Risco

{
  "status": 1,
  "cnpj": "11.222.333/0001-81",
  "razao": "TOKEN TEST LTDA",
  "risco": {"nivel": 2, "descricao": "Médio", "score": "251-600"},
  "pacoteUsado": 12,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 13 — CPF Risco

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "risco": {"nivel": 2, "descricao": "Médio", "score": "501-700"},
  "pacoteUsado": 13,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 14 — CPF PPE

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "ppe": [
    {"sigla": "001", "funcao": "PRESIDENTE DA REPUBLICA", "nivel": "001", "orgao": "PRESIDENCIA DA REPUBLICA", "inicioexercicio": "01/01/2019", "fimexercicio": null, "fimcarencia": null}
  ],
  "relacionados": [
    {"cpf": "11122233344", "nome": "Relacionado Teste", "parentesco": "IRMA(O)", "situacaocadastral": "Regular", "ppe": []}
  ],
  "pacoteUsado": 14,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 15 — CPF Empresas

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "empresas": [
    {"cnpj": "77888999000110", "razao": "LOJA LTDA", "fantasia": "MINHA LOJA", "dataSociedade": "01/02/2018", "qualificacao": "SOCIO-ADMINISTRADOR", "situacao": "Ativa"},
    {"cnpj": "11222333000120", "razao": "EMPRESA LTDA", "fantasia": null, "dataSociedade": "02/12/2020", "qualificacao": "SOCIO-ADMINISTRADOR", "situacao": "Baixada"}
  ],
  "pacoteUsado": 15,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 20 — CPF BNMP (Mandados de Prisão)

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "nascimento": "31/12/1900",
  "mae": "Maria Jose",
  "mandados": [
    {"id": "BNMP-0001", "tribunal": "TJSP", "orgaoJudiciario": "Vara Criminal de São Paulo", "tipoPeca": "Mandado de Prisão", "status": "Em aberto", "dataExpedicao": "01/03/2025", "recaptura": false}
  ],
  "pacoteUsado": 20,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 21 — CPF Telefones+WhatsApp+Emails

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "nascimento": "31/12/1900",
  "telefones": ["11999999999", "3188888888", "2133334444"],
  "whatsapp": ["11999999999"],
  "emails": ["[email protected]", "[email protected]"],
  "pacoteUsado": 21,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 22 — CPF Programas Sociais

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "programasSociais": [
    {"programa": "BPC", "nis": "1.111.111.111-1", "municipio": "Montes Claros", "ano": 2025, "valorDisponibilizado": 3036},
    {"programa": "Novo Bolsa Família", "nis": "1.111.111.111-1", "municipio": "Montes Claros", "ano": 2025, "valorDisponibilizado": 800}
  ],
  "pacoteUsado": 22,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 23 — CPF Antecedentes Criminais (BNMP + Interpol + CAC)

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "nascimento": "31/12/1900",
  "mandados": [
    {"id": "BNMP-0001", "tribunal": "TJSP", "orgaoJudiciario": "Vara Criminal de São Paulo", "tipoPeca": "Mandado de Prisão", "status": "Em aberto", "dataExpedicao": "01/03/2025", "recaptura": false}
  ],
  "interpol": [
    {
      "entityId": "2025/12345",
      "name": "TEST TOKEN",
      "forename": "TEST",
      "dateOfBirth": "1900/12/31",
      "nationalities": ["BR"],
      "eyeColor": "Brown",
      "hairColor": "Black",
      "sexId": "M",
      "weight": 80,
      "height": 1.75,
      "arrestWarrants": [
        {"charge": "Test charge", "issuingCountryId": "BR", "chargeTranslation": "Mandado de teste"}
      ]
    }
  ],
  "cac": {
    "nrProtocolo": "123456789012",
    "comprovantePdfBase64": "base64",
    "nadaConsta": true
  },
  "pacoteUsado": 23,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 24 — CPF CNS (Cartão Nacional de Saúde)

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "cns": "123456789012345",
  "pacoteUsado": 24,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 25 — CNPJ Percentual Societário

{
  "status": 1,
  "cnpj": "11.222.333/0001-81",
  "razao": "TOKEN TEST LTDA",
  "fantasia": "TOKEN TEST",
  "socios": [
    {"cpf_cnpj_socio": "111.111.111-11", "nome": "Sócio Teste", "qualificacao_socio": "ADMINISTRADOR", "data_entrada": "14/11/2018", "percentual": 40},
    {"cpf_cnpj_socio": "11.111.111/0001-11", "nome": "CORPORATION, INC.", "qualificacao_socio": "SOCIO PESSOA JURIDICA DOMICILIADO NO EXTERIOR", "data_entrada": "17/09/2015", "percentual": 60}
  ],
  "pacoteUsado": 25,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 26 — CPF Básico

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "nascimento": "31/12/1900",
  "genero": "M",
  "pacoteUsado": 26,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 27 — CPF CAC/SINIC (Antecedentes Criminais PF)

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "cac": {
    "nrProtocolo": "123456789012",
    "comprovantePdfBase64": "base64",
    "nadaConsta": true
  },
  "pacoteUsado": 27,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Consultando Saldos

Sem custos, consulte o saldo do pacote desejado.

Definição

Endpoint que conterá o Token e ID do IDs dos Pacotes, respectivamente.

Parâmetros da Requisição

Parâmetros da Resposta

Objeto pacote{} com informações de saldo:

Códigos de Erro

Lista de erros retornados nos parâmetros erro e erroCodigo: