À 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:

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.

Content-Type: application/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.

ID
 Forfait Données Retournées Coût par Requête (BRL)
1 CPF A
  • Nome Completo
 R$ 0,15 BRL
7 CPF B
  • Nome Completo
  • Data de Nascimento
 R$ 0,22 BRL
2 CPF C
  • Nome Completo
  • Data de Nascimento
  • Nome Completo da Mãe
  • Gênero
 R$ 0,25 BRL
8 CPF D
  • Nome Completo
  • Nome Social
  • Data de Nascimento
  • Situação Cadastral na Receita Federal
  • Óbito e Data
  • Número de Comprovante da Consulta
  • PDF Comprovante da Consulta

Consultas em tempo real com a Receita Federal e resposta em 1 segundo!

 R$ 0,36 BRL
9 CPF E
  • Nome Completo
  • Nome Social
  • Nome Completo da Mãe
  • Data de Nascimento
  • Gênero
  • Situação Cadastral na Receita Federal
  • Óbito e Data
  • Número de Comprovante da Consulta
  • PDF Comprovante da Consulta

Consultas em tempo real com a Receita Federal e resposta em 1 segundo!

 R$ 0,47 BRL
3 CPF F
  • Nome Completo
  • Data de Nascimento
  • Gênero
  • Endereço Completo
 R$ 1,20 BRL
14 CPF H
  • Nome Completo¹
  • Pessoa Politicamente Exposta e Relacionados (PPE / PEP)

Também retorna relacionados familiares.

Clique aqui e leia nosso artigo para mais informações.

¹ Caso não seja uma PPE/PEP (ou relacionado), o retorno será null.
² A cobrança também é feita se o CPF consultado não for uma PPE/PEP.

 R$ 0,20² BRL
15 CPF I
  • Empresas no Nome

Lista de CNPJs em que o titular faz parte do quadro societário.

 R$ 0,20 BRL
17 CPF J
  • Nome Completo
  • Nacionalidade (ID + País)
 R$ 0,18 BRL
18 CPF K
  • Nome Completo
  • Data de Nascimento
  • Endereço Completo
  • Situação Cadastral na Receita Federal

Apenas a Situação Cadastral em tempo real, sem comprovante.

 R$ 1,40 BRL
21 CPF Lookalike
  • Nome Completo
  • E-mails
  • Telefones
  • WhatsApp
 R$ 0,24 BRL
20 CPF Family
R$ 1,00 BRL
22 CPF Programas Sociais
  • Nome Completo
  • Lista dos Programas Sociais em que o titular é participante no atual ano
 R$ 0,15 BRL
23 CPF Antecedentes Criminais
  • Mandados de Busca e Apreensão
  • Lista INTERPOL
 R$ 1,30 BRL
24 CPF CNS
R$ 0,22 BRL
26 CPF D Simplificado
  • Nome Completo
  • Data de Nascimento
  • Situação Cadastral na Receita Federal
 R$ 0,33 BRL
4 CNPJ A
  • Razão Social
Para pesquisar empresas por meio da Razão Social, use o endpoint, exemplo /4/?razao_social=GOOGLE BRASIL 		R$ 0,13 BRL
5 CNPJ B
  • Razão Social
  • Nome Fantasia
  • Endereço Completo
 R$ 0,24 BRL
10 CNPJ C
  • Razão Social
  • Nome Fantasia
  • Endereço Completo
  • Início das Atividades
  • Telefones
  • Faxes
  • E-mail
  • Situação Cadastral na Receita Federal
 R$ 0,32 BRL
6 CNPJ D
  • Razão Social
  • Nome Fantasia
  • Endereço Completo
  • Início das Atividades
  • Telefones
  • Faxes
  • E-mail
  • Código e Descrição da Atividade Econômica Principal
  • Código e Descrição da Natureza Jurídica
  • Nome do Responsável pela Empresa
  • Porte da Empresa
  • Quadro de Sócios e Administradores (QSA)
  • Situação Cadastral na Receita Federal
  • Informações sobre Simples Nacional
  • CPF do Responsável Legal e Sócios
 R$ 0,45 BRL
11 CNPJ F
  • Razão Social
  • Informações sobre Simples Nacional
  • Informações sobre SIMEI
  • Informações sobre Suframa
 R$ 0,30 BRL
16 CNPJ H
  • Inscrições Estaduais
  • Razão Social
 R$ 0,15 BRL
19 CNPJ Lookalike
  • Razão Social
  • E-mails dos Sócios
  • Telefones dos Sócios
  • WhatsApp dos Sócios

Cobrança feita por cada sócio retornado.

 R$ 0,26 BRL
25 CNPJ QsA Detalhado
  • Porcentagem Societária de cada Sócio
 R$ 2,00 BRL
100 NFe Unificada PF e PJ
  • Consulta em tempo real de notas fiscais NFe PF e PJ
 R$ 0,15 BRL

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.

URL: https://api.cpfcnpj.com.br/{token}/{pacote}/{cpfcnpj}

Paramètres de la Requête

Paramètre Type Description Obligatoire?
token string Token généré dans le Panneau de Contrôle.
pacote int ID du forfait à utiliser, selon le tableau.
cpfcnpj string Numéro CPF avec 11 chiffres ou CNPJ avec 14 chiffres.

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 D: 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:

Paramètre Type Description
status bool 1 pour succès et 0 pour échec (voir tableau des erreurs).
cpf string Numéro CPF formaté avec 14 chiffres.
nome string Nom complet du titulaire (sans accentuation).
nomeSocial string Nom social, conformément au Décret nº 8.727/2016.
nascimento string Date de naissance, format JJ/MM/AAAA.
mae string Nom complet de la mère (sans accentuation).
genero string M (Masculin), F (Féminin) ou O (Autre).
situacao string Situation d'inscription: Regular, Cancelada, Suspensa, Pendente, Nula.
situacaoDigito string Code de la situation (00, 02, 03, 04, 05, 08, 09).
situacaoMotivo string Motif de la situation d'inscription.
situacaoAnoObito string Année de décès (JJ/MM/AAAA), le cas échéant.
situacaoInscricao string Date d'inscription à l'administration fiscale (JJ/MM/AAAA ou texte du type "antérieur à ...").
situacaoComprovante string Code de contrôle du certificat en temps réel.
situacaoComprovanteEmissao string Date (JJ/MM/AAAA HH:MM:SS) à laquelle la requête a été effectuée auprès de l'administration fiscale (temps réel).
situacaoComprovantePdf string PDF de la requête en base64.
endereco string Adresse résidentielle principale (rue).
numero string Numéro de l'adresse.
complemento string Complément de l'adresse.
bairro string Quartier de l'adresse.
cep string Code postal de l'adresse.
cidade string Ville de l'adresse.
uf string État (UF) avec 2 lettres.
enderecos enderecos[] Liste contenant l'historique des adresses et aussi la plus récente (la même en dehors de cet objet).
telefones telefones[] Liste contenant l'historique des numéros de téléphone possibles.
whatsapp whatsapp[] Sur la base de la liste téléphonique, une vérification en temps réel est effectuée pour identifier quels numéros sont WhatsApp.
emails emails[] Liste contenant l'historique des emails possibles.
ppe ppe[] Liste des postes PPE/PEP, s'il s'agit d'une Personne Politiquement Exposée.
relacionados relacionados[] Liste des parents liés qui sont PPE/PEP.
empresas empresas[] Liste contenant le CNPJ des entreprises dans lesquelles le titulaire fait partie de la structure de l'entreprise.
programasSociais programasSociais[] Liste contenant les programmes sociaux dans lesquels le titulaire est bénéficiaire dans l'année en cours.
pacoteUsado int ID du forfait utilisé.
saldo int Solde du forfait après la requête.
consultaID string ID de la requête (16 chiffres).
delay float Temps total de la requête en secondes.
Tableau PPE

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

Parâmetro Tipo Descrição
sigla string Sigle du poste politique.
funcao string Fonction du poste.
nivel string Niveau de hiérarchie politique.
orgao string Organisme d'exercice.
inicioexercicio string Date de début (JJ/MM/AAAA).
fimexercicio string Date de fin de mandat (JJ/MM/AAAA).
fimcarencia string Date de fin de période de grâce (JJ/MM/AAAA).

Réponses CNPJs

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

Parâmetro Tipo Descrição
status bool 1 pour succès et 0 pour échec (voir tableau des erreurs).
cnpj string CNPJ formaté (18 chiffres).
razao string Raison sociale de l'entreprise.
fantasia string Nom commercial de l'entreprise.
inicioAtividade string Date de début d'activité (JJ/MM/AAAA).
email string E-mail d'inscription de l'entreprise.
responsavel string Nom du responsable légal (sans accentuation).
responsavelCpf string CPF du responsable légal.
simplesNacional simplesNacional[] Données d'éventuelle adhésion au Simples Nacional.
simei simei[] Données d'éventuelle adhésion au SIMEI.
matrizEndereco matrizEndereco[] Objet de l'adresse complète du CNPJ consulté.
Attention: Le nom "matriz" de l'objet en question ne fait pas spécifiquement référence à l'adresse du siège du CNPJ consulté.
matrizfilial matrizfilial[] Données de l'autorité compétente (siège/succursale).
telefones telefones[] Téléphones de l'entreprise (jusqu'à 2).
fax fax[] Fax de l'entreprise.
situacao situacao[] Situation d'inscription à l'administration fiscale.
naturezaJuridica naturezaJuridica[] Données de la nature juridique.
cnae cnae[] CNAE principal.
porte porte[] Données de la taille de l'entreprise.
socios socios[] QSA: associés/administrateurs.
pacoteUsado int ID du forfait utilisé.
saldo int Solde du forfait après la requête.
consultaID string ID de la requête (16 chiffres).
delay float Temps pour traiter la requête (secondes).
Objeto simplesNacional

Objeto simplesNacional[] contendo informações de Simples Nacional:

Parâmetro Tipo Descrição
optante string Sim ou Não.
inicio string Data início (DD/MM/AAAA).
fim string Data fim (DD/MM/AAAA).
Objeto simei

Objeto simei[] contendo informações de SIMEI:

Parâmetro Tipo Descrição
optante string Sim ou Não.
anteriores matriz Objeto anteriores[] com registros anteriores.
Objeto anteriores
Parâmetro Tipo Descrição
inicio string Data início (DD/MM/AAAA).
fim string Data fim (DD/MM/AAAA).
detalhamento string Descrição do registro.
Objeto matrizEndereco
Parâmetro Tipo Descrição
cep string CEP com 9 dígitos.
tipo string Tipo de endereço (ex: Rua, Avenida etc.).
logradouro string Logradouro da empresa.
numero string Numéro de l'adresse.
complemento string Complément de l'adresse.
bairro string Quartier de l'adresse.
cidade string Ville de l'adresse.
uf string État (UF) avec 2 lettres.
Objeto matrizfilial

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

Parâmetro Tipo Descrição
id int ID do órgão.
tipo string Órgão:

id 1: Matriz
id 2: Filial
Array telefones
Parâmetro Tipo Descrição
ddd string DDD do telefone.
numero string Número do telefone.
Objeto fax
Parâmetro Tipo Descrição
ddd string DDD do fax.
numero string Número do fax.
Objeto situacao
Parâmetro Tipo Descrição
id int ID da situação cadastral.
nome string Nome da situação, por exemplo:

id 1: Baixada
id 2: Ativa
id 3: Suspensa
id 4: Inapta
id 8: Baixada
data string Data da situação (DD/MM/AAAA).
Objeto naturezaJuridica

Objeto naturezaJuridica[] com dados da natureza jurídica.
Lista oficial

Parâmetro Tipo Descrição
codigo string Código da natureza jurídica (4 dígitos).
descricao string Descrição da natureza jurídica.
Objeto cnae

Objeto cnae[] com dados do CNAE principal.
Tabela CNAE

Parâmetro Tipo Descrição
divisao string Código da divisão.
grupo string Código do grupo.
classe string Código da classe.
subClasse string Código da subclasse.
fiscal string Código completo do CNAE (somente números).
descricao string Descrição do CNAE.
Objeto porte

Objeto porte[] contendo dados do porte da empresa.

Parâmetro Tipo Descrição
id string ID do porte.
descricao string Descrição do porte, por exemplo:

id 0: Demais
id 1: Matriz
id 3: Demais
id 5: Demais
Array socios

Objeto socios[] contendo dados do QSA:

Parâmetro Tipo Descrição
cpf_cnpj_socio string CPF completo ou CNPJ do sócio.
nome string Nome do sócio PF ou Razão Social PJ.
tipo string Pessoa Física ou Pessoa Jurídica
data_entrada string Data de entrada na dociedade no formato DD/MM/YYYY.
cpf_representante_legal string CPF completo do Representante Legal quando sócio Pessoa Jurídica.
nome_representante string Nome do Representante Legal quando sócio Pessoa Jurídica.
faixa_etaria string Faixa etária do representante PF.
atualizado_em datetime Data e hora da última atualização das informações do sócio.
pais_id string ID do país de origem do sócio.
qualificacao_socio objeto Contendo id e descricao da qualificação do sócio.
qualificacao_representante objeto Contendo id e descricao da qualificação do representante PF em caso de sócio PJ.
pais objeto Contendo id, iso2, iso3, nome do país e comex_id do representante PF em caso de sócio PJ.

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.

URL: https://api.cpfcnpj.com.br/{token}/saldo/{pacote}

Paramètres de la Requête

Parâmetro Tipo Descrição Obrigatório?
token string Token gerado no Painel de Controle.
pacote int ID do pacote (ver tabela).

Paramètres de Réponse

Objeto pacote[] avec les informations de solde:

Parâmetro Tipo Descrição
id int ID do pacote.
nome string Nome do pacote.
saldo int Saldo disponível.

Codes d'Erreur

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

erroCodigo
 Valeur erro Description
100
 CPF CPF inválido! Le numéro saisi n'est pas un CPF valide.
101
 CPF Informe um CPF com 11 dígitos! Le CPF saisi a moins de 11 chiffres.
102
 CPF O CPF informado não existe (...) CPF valide, mais non trouvé dans les bases de l'administration fiscale.
200
 CNPJ CNPJ inválido! Le numéro saisi n'est pas un CNPJ valide.
201
 CNPJ Informe um CNPJ com 14 dígitos! Le CNPJ saisi a moins de 14 chiffres.
202
 CNPJ O CNPJ informado não existe (...) CNPJ valide, mais non trouvé dans les bases de l'administration fiscale.
400
 CPF/CNPJ Incorrect parameters. Le formatage de l'URI est incorrect. Vérifiez les instructions dans la section "Effectuer des Requêtes > Définition".
1000
 CPF/CNPJ Token inválido! (...) Le Token n'appartient pas à l'IP d'origine.
1001
 CPF/CNPJ Créditos insuficientes! Pas de crédits dans le forfait sélectionné.
1002
 CPF/CNPJ Conta suspensa e/ou inativa! Contactez le support.
1003
 CPF/CNPJ Blacklist até *DATA* IP et Token temporairement suspendus.
1004
 CPF/CNPJ Pacote indisponível para consultas! ID de forfait invalide ou indisponible.
1005
 CPF/CNPJ Não é possível consultar *CPF/CNPJ* neste pacote! Échec du fournisseur ou erreur interne.
1006
 CPF/CNPJ Supplier 2 offline. Contact us! Fournisseur de données hors ligne.
1007
 CPF/CNPJ Limite de requisições (20) por segundo excedido... Maximum de 20 requêtes par seconde.