Documentation API - CPF.CNPJ

About

API for CPF lookup in the Brazilian Federal Revenue Service, enabling agile integration without captcha or date of birth. Get individual and company data in real-time, reducing fraud and ensuring the reliability of registrations in your applications.

Furthermore, our CPF and CNPJ lookup API has an average response time below 1 second, enabling process automation and maintaining a complete and secure database.
Learn more on our website.

Certifications

In 2025, we obtained three outstanding ISO/IEC certifications that demonstrate our commitment to privacy, information security, and regulatory compliance:

• Information Security Management 27001:2022 (Certificate Q7LUQTCU20251113BRAIS1Z1): certifies our Information Security Management System, ensuring data confidentiality, integrity, and availability.
• Privacy Information Management 27701:2025 (Certificate Q7LUQTCU20251113BRAPI15R): attests our compliance with best practices in privacy information management, including LGPD and GDPR.
• Compliance Management System 37301:2021 (Certificate Q7LUQTCC20251113BRACM1X7): demonstrates our adherence to a robust compliance management system, ensuring compliance with standards and regulations.

To learn more about our processes and policies, see:

• General Data Protection Law (LGPD)
• Security and Compliance
• Privacy Policies
• Terms of Use

Data Accuracy and Updates

We provide only real-time updated data (D+0) with 100% coverage of queried documents. Thus, any registration change by the holder is reflected exactly as it appears in the Federal Revenue Service. Unlike many providers in the market, we do not use old, incomplete, or leaked databases, which allows us to guarantee full coverage for all queried documents.

For more information, visit: www.cpfcnpj.com.br

Introduction

This document presents the guidelines for quickly integrating with CPF.CNPJ services via HTTP (HTTP API).
Any programming language is compatible with our solution.

Rules and Usage Limits

To prevent API misuse and maintain high availability, we have established the following restrictions:

• After 3 consecutive queries with invalid Token: 5-minute block;
• After 3 consecutive queries of the same CPF/CNPJ in the same package in less than 1 minute: 3-minute block;
• After 3 consecutive queries without credits in less than 1 minute: 5-minute block.

There is also a limit of 20 requests per second. If this limit is reached, wait for the next second and try again. If necessary, you can request an increase in this limit directly with technical support.

Base URL

GET requests are made to a base URL under the HTTPS.

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

Firewall

Make sure to grant permissions in your firewall for CloudFlare IPs.

Access the IP list for whitelisting: https://www.cloudflare.com/ips/

Content-Type

The API data response will be via JSON.

Timeout

Use the default timeout of 60 seconds. If you use a lower value, during API instability your request may be aborted before receiving the response, consuming credits.

Currently, the average query response time is 2 seconds.

Tokens

To make queries, you will need to generate the integration token. To do this, access the option API > Tokens in your Control Panel. After registration, your token will be generated to be inserted in the URL of the request.

Package IDs

In each request, you will need to inform the Package ID in the URL, here named as {pacote}.

To purchase the desired packages, access the Control Panel. Check them on our website.

Making Queries

In a few steps, we will explain how queries are made through the CPF.CNPJ API.

After generating the token, as per Introduction, you will need to build the request URL.

Definition

Endpoint that will contain the Token, Package ID and CPF or CNPJ number to be queried, respectively.

Request Parameters

URL Examples:

Query CPF in package CPF E: https://api.cpfcnpj.com.br/5ae973d7a997af13f0aaf2bf60e65803/9/00000000000

Query CNPJ in package CNPJ D: https://api.cpfcnpj.com.br/5ae973d7a997af13f0aaf2bf60e65803/6/27272134000118

Query company list by Business Name in package CNPJ A: https://api.cpfcnpj.com.br/5ae973d7a997af13f0aaf2bf60e65803/4?razao_social=GOOGLE BRASIL

Response Parameters

Check below the fields returned for CPFs and CNPJs.

Each query package has its own response parameters. Therefore, integrate accordingly.

CPF Responses

Main response object that varies according to the package:

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).

PPE Array

Array ppe[] containing list of PEP positions:

Array relacionados (PPE)

Array relacionados[] containing close relatives of the holder who hold a PEP position. Returned in CPF PPE Package (14).

Array empresas

Array empresas[] containing companies in which the CPF is partner or administrator. Returned in CPF Empresas Package (15).

Array programasSociais

Array programasSociais[] containing active social benefits for the CPF. Returned in CPF Social Programs Package (22).

Array mandados (BNMP)

Array mandados[] containing arrest warrants registered in the National Arrest Warrants Database (BNMP/CNJ). Returned in CPF BNMP (20) and CPF Criminal Background (23) packages.

Array interpol

Array interpol[] containing Interpol red/yellow notices. Returned in CPF Criminal Background Package (23).

Object arrestWarrant (interpol)

Inner object of each interpol[].arrestWarrants[] item.

Objeto nacionalidade

Objeto nacionalidade{} com a nacionalidade declarada do CPF.

Array enderecos (PF)

Array enderecos[] with additional addresses known for the CPF. The main address is already returned in the root fields endereco, numero, cep, etc.

Array telefones (PF)

Array telefones[] of strings (phone numbers in E.164 format without the plus sign, or DDD+number depending on source). Example: ["11999999999","3188888888"].

Array whatsapp (PF)

Array whatsapp[] of strings with phone numbers having confirmed active WhatsApp. Subset of telefones[].

Array emails (PF)

Array emails[] of strings with email addresses known for the CPF.

CNPJ Responses

Main response object that varies according to the package:

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
}

Checking Balance

At no cost, check the balance of the desired package.

Definition

Endpoint that will contain the Token and Package IDsID, respectively.

Request Parameters

Response Parameters

Objeto pacote{} with balance information:

Error Codes

List of errors returned in parameters erro and erroCodigo: