Documentation API - CPF.CNPJ

À propos

API pour la consultation de CPF auprès de l'administration fiscale brésilienne, permettant une intégration agile, sans captcha ni date de naissance. Ainsi, vous obtenez des données sur les personnes et les entreprises en temps réel, réduisant les fraudes et garantissant la fiabilité des inscriptions dans vos applications.

De plus, notre API pour la consultation de CPF et CNPJ a un temps de réponse moyen inférieur à 1 seconde, permettant l'automatisation des processus et le maintien d'une base de données complète et sécurisée.
En savoir plus sur notre site.

Certifications

En 2025, nous avons obtenu trois certifications ISO/IEC remarquables qui démontrent notre engagement envers la vie privée, la sécurité de l'information et la conformité réglementaire:

• Information Security Management 27001:2022 (Certificat Q7LUQTCU20251113BRAIS1Z1) : certifie notre Système de Gestion de la Sécurité de l'Information, garantissant la confidentialité, l'intégrité et la disponibilité des données.
• Privacy Information Management 27701:2025 (Certificat Q7LUQTCU20251113BRAPI15R) : atteste notre conformité aux meilleures pratiques de gestion de la confidentialité de l'information, y compris LGPD et RGPD.
• Compliance Management System 37301:2021 (Certificat Q7LUQTCC20251113BRACM1X7) : démontre notre adhésion à un système de gestion de la conformité robuste, assurant le respect des normes et réglementations.

Pour en savoir plus sur nos processus et politiques, consultez:

• Loi Générale sur la Protection des Données (LGPD)
• Sécurité et Conformité
• Politiques de Confidentialité
• Conditions d'Utilisation

Véracité et Mise à Jour des Données

Nous fournissons uniquement des données mises à jour en temps réel (D+0) avec une couverture de 100% des documents consultés. Ainsi, tout changement d'inscription du titulaire est reflété exactement tel qu'il apparaît dans l'administration fiscale. Contrairement à de nombreux fournisseurs sur le marché, nous n'utilisons pas de bases de données anciennes, incomplètes ou divulguées, ce qui nous permet de garantir une couverture complète pour tous les documents consultés.

Pour plus d'informations, accédez à: www.cpfcnpj.com.br

Introduction

Ce document présente les directives pour intégrer rapidement les services de CPF.CNPJ via HTTP (HTTP API).
Tout langage de programmation est compatible avec notre solution.

Règles et Limites d'Utilisation

Pour éviter une utilisation abusive de l'API et maintenir sa haute disponibilité, nous avons établi les restrictions suivantes:

• Après 3 requêtes consécutives avec un Token invalide : blocage de 5 minutes ;
• Après 3 requêtes consécutives du même CPF/CNPJ dans le même forfait en moins d'1 minute : blocage de 3 minutes ;
• Après 3 requêtes consécutives sans crédits en moins d'1 minute : blocage de 5 minutes.

Il y a aussi une limite de 20 requêtes par seconde. Si cette limite est atteinte, attendez la seconde suivante et réessayez. Si nécessaire, vous pouvez demander une augmentation de cette limite directement auprès du support technique.

URL de Base

Les requêtes GET sont effectuées vers une URL de base sous le protocole HTTPS.

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

Pare-feu

Assurez-vous d'accorder des permissions dans votre pare-feu pour les IPs de CloudFlare.

Accédez à la liste des IPs pour autorisation: https://www.cloudflare.com/ips/

Content-Type

Le retour des données de l'API sera via JSON.

Timeout

Utilisez le timeout par défaut de 60 secondes. Si vous utilisez une valeur inférieure, en cas d'instabilité de l'API, votre requête pourrait être interrompue avant de recevoir la réponse, consommant des crédits.

Actuellement, le temps de réponse moyen des requêtes est de 2 secondes.

Tokens

Pour effectuer des requêtes, vous devrez générer le token d'intégration. Pour cela, accédez à l'option API > Tokens dans votre Panneau de Contrôle. Après l'inscription, votre token sera généré pour être inséré dans l' URL de la requête.

IDs des Forfaits

Dans chaque requête, vous devrez informer dans l'URL l'ID du Forfait souhaité, ici nommé {pacote}.

Pour souscrire aux forfaits souhaités, accédez au Panneau de Contrôle. Consultez-les sur notre site.

Effectuer des Requêtes

En quelques étapes, nous expliquerons comment les requêtes sont effectuées via l'API CPF.CNPJ.

Après avoir généré le token, conformément à Introduction, vous devrez construire l'URL de la requête.

Définition

Endpoint qui contiendra le Token, l'ID du Forfait et le numéro CPF ou CNPJ à consulter, respectivement.

Paramètres de la Requête

Exemples d'URL:

Consulter CPF dans le forfait CPF E: https://api.cpfcnpj.com.br/5ae973d7a997af13f0aaf2bf60e65803/9/00000000000

Consulter CNPJ dans le forfait CNPJ D: https://api.cpfcnpj.com.br/5ae973d7a997af13f0aaf2bf60e65803/6/27272134000118

Consulter la liste des entreprises par Raison Sociale dans le forfait CNPJ A: https://api.cpfcnpj.com.br/5ae973d7a997af13f0aaf2bf60e65803/4?razao_social=GOOGLE BRASIL

Paramètres des Réponses

Consultez ci-dessous les champs retournés pour les CPFs et CNPJs.

Chaque forfait de requêtes possède ses propres paramètres de réponse. Par conséquent, intégrez en conséquence.

Réponses CPFs

Objet principal de la réponse qui varie selon le forfait:

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

Tableau PPE

Array ppe[] contenant la liste des postes PPE/PEP:

Array relacionados (PPE)

Array relacionados[] contenant des proches du titulaire occupant un poste PPE. Retourné dans le Pack CPF PPE (14).

Array empresas

Array empresas[] contenant des entreprises dont le CPF est associé ou administrateur. Retourné dans le Pack CPF Empresas (15).

Array programasSociais

Array programasSociais[] contenant les bénéfices sociaux actifs pour le CPF. Retourné dans le Pack CPF Programas Sociais (22).

Array mandados (BNMP)

Array mandados[] contenant des mandats d'arrêt enregistrés dans la base nationale BNMP/CNJ. Retourné dans les Packs CPF BNMP (20) et CPF Antécédents Criminels (23).

Array interpol

Array interpol[] contenant les notices rouges/jaunes Interpol. Retourné dans le Pack CPF Antécédents Criminels (23).

Objet arrestWarrant (interpol)

Objet interne de chaque item interpol[].arrestWarrants[].

Objeto nacionalidade

Objeto nacionalidade{} com a nacionalidade declarada do CPF.

Array enderecos (PF)

Array enderecos[] avec adresses additionnelles connues pour le CPF. L'adresse principale est dans les champs endereco, numero, cep à la racine.

Array telefones (PF)

Array telefones[] de strings (téléphones au format E.164 sans le signe plus, ou DDD+numéro selon la source). Exemple : ["11999999999","3188888888"].

Array whatsapp (PF)

Array whatsapp[] de strings avec numéros ayant WhatsApp actif confirmé. Sous-ensemble de telefones[].

Array emails (PF)

Array emails[] de strings avec adresses e-mail connues pour le CPF.

Réponses CNPJs

Objet principal de la réponse qui varie selon le forfait:

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
}

Consultation des Soldes

Sans frais, consultez le solde du forfait souhaité.

Définition

Endpoint qui contiendra le Token et l'ID du IDs des Forfaits, respectivement.

Paramètres de la Requête

Paramètres de Réponse

Objeto pacote{} avec les informations de solde:

Codes d'Erreur

Liste des erreurs retournées dans les paramètres erro et erroCodigo: