À propos de

API pour la consultation du CPF avec le Service fédéral du revenu, permettant une intégration agile sans captcha ni date de naissance. Cela vous permet d'obtenir des données sur les personnes et les entreprises en temps réel, réduisant ainsi la fraude et garantissant la fiabilité des enregistrements dans vos applications.

De plus, notre API pour les requêtes CPF et CNPJ a un temps de réponse moyen inférieur à 1 seconde, ce qui permet d'automatiser les processus et de maintenir une base de données complète et sécurisée.
Pour en savoir plus, consultez notre site web.

Certifications

En 2025, nous avons obtenu trois certifications exceptionnelles qui prouvent notre engagement en matière de protection de la vie privée, de sécurité de l'information et de respect de la loi :

Sceau LGPD Sceau GDPR Sceau cybernétique

  • Sceau LGPD: certifie notre conformité totale avec la loi générale sur la protection des données, garantissant le traitement correct et sûr des données personnelles au Brésil.
  • Sceau GDPR: confirme notre adhésion aux normes européennes de protection des données, garantissant des niveaux élevés de confidentialité à l'échelle mondiale.
  • Sceau CyberSec: reconnaît nos bonnes pratiques en matière de cybersécurité, renforçant la protection des systèmes et des informations contre les menaces numériques.

Pour en savoir plus sur nos procédures et nos politiques, voir :

Exactitude et mise à jour des données

Nous ne fournissons que des données mises à jour en temps réel (J+0). Cela signifie que tout changement dans l'enregistrement du propriétaire est reflété exactement tel qu'il apparaît dans la Receita Federal. Contrairement à de nombreux fournisseurs sur le marché, nous n'utilisons pas de bases de données anciennes, incomplètes ou ayant fait l'objet de fuites, ce qui nous permet de garantir une couverture complète pour tous les documents consultés.

Pour plus d'informations, voir : www.cpfcnpj.com.br

Introduction

Ce document présente les lignes directrices pour une intégration rapide avec les services de CPF.CNPJ via HTTP (HTTP API).
Tout langage de programmation est compatible avec notre solution.

Règles d'utilisation

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

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

URL de base

Les demandes GET sont effectuées sur une URL de base sous le protocole HTTPS.

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

Pare-feu

Assurez-vous que vous accordez des autorisations sur votre pare-feu pour les IP de CloudFlare.

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

Content-Type

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

Content-Type : application/json.

Délai d'attente

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

Actuellement, le délai moyen de traitement des requêtes est de 2 secondes.

Jetons

Pour effectuer des demandes de renseignements, vous devez générer le jeton d'intégration. Pour ce faire, rendez-vous sur API > Tokens dans votre Panneau de contrôle. Après l'enregistrement, votre jeton sera généré afin d'être inséré dans l'application URL de la demande.

ID des paquets

Dans chaque demande, il faudra renseigner dans l'URL l'ID du paquet souhaité, ici nommé {pacote}.

Pour contracter les paquets que vous souhaitez, allez dans le panneau de contrôle. Consultez-les sur notre site web.

ID
 Pacote Données retournées Coût par consultation (BRL)
1 CPF A
  • Nom complet
 R$0,15
7 CPF B
  • Nom complet
  • Date de naissance
 R$0,22
2 CPF C
  • Nom complet
  • Date de naissance
  • Nom complet de la mère
  • Genre
 R$0,25
8 CPF D
  • Nom complet
  • Nom social
  • Date de naissance
  • Situation cadastrale à la recette fédérale
  • Décès et date
  • Numéro du bon de consultation
  • PDF Épreuve de consultation

Demandes de renseignements en temps réel auprès de l'IRS et réponse en 1 seconde !

 R$0,36
9 CPF E
  • Nom complet
  • Nom social
  • Nom complet de la mère
  • Date de naissance
  • Genre
  • Situation cadastrale à la recette fédérale
  • Décès et date
  • Numéro du bon de consultation
  • PDF Épreuve de consultation

Demandes de renseignements en temps réel auprès de l'IRS et réponse en 1 seconde !

 R$0,47
3 CPF F
  • Nom complet
  • Date de naissance
  • Genre
  • Adresse complète
 R$1,20
13 CPF G
  • Nom complet
  • Niveau de probabilité de défaut futur, selon SERASA.

Cliquez ici et lisez notre article pour plus d'informations.

 R$1,00
14 CPF H
  • Nom complet¹
  • Personnes politiquement exposées et personnes apparentées (PPE / PEP)

Il revient également avec des membres de sa famille.

Cliquez ici et lisez notre article pour plus d'informations.

¹ S'il ne s'agit pas d'un PPE/PEP (ou d'un produit apparenté), la déclaration sera la suivante null.
² L'imputation est également effectuée si le CPF consulté n'est pas un PPE/PEP.

 R$0,20²
15 CPF I
  • Entreprises au nom de

Liste des CNPJ dont le propriétaire est membre de l'entreprise.

 R$0,20
17 CPF J
  • Nom complet
  • Nationalité (ID + Pays)
 R$0,18
18 CPF K
  • Nom complet
  • Date de naissance
  • Adresse complète
  • Situation cadastrale à la recette fédérale

Seulement le statut d'enregistrement en temps réel, sans preuve.

 R$1,40
21 Sosie du CPF
  • Nom complet
  • E-mails
  • Téléphones
  • WhatsApp
 R$0,24
4 CNPJ A
  • Nom de la société
 R$0,13
5 CNPJ B
  • Nom de la société
  • Nom de la société
  • Adresse complète
 R$0,24
10 CNPJ C
  • Nom de la société
  • Nom de la société
  • Adresse complète
  • Début des activités
  • Téléphones
  • Télécopies
  • Courriel :
  • Situation cadastrale à la recette fédérale
 R$0,32
6 CNPJ D
  • Nom de la société
  • Nom de la société
  • Adresse complète
  • Début des activités
  • Téléphones
  • Télécopies
  • Courriel :
  • Code et description de la principale activité économique
  • Code et description de la nature juridique
  • Nom de la personne responsable de l'entreprise
  • Taille de l'entreprise
  • Conseil des partenaires et des directeurs (QSA)
  • Situation cadastrale à la recette fédérale
  • Informations sur Simples Nacional
 R$0,45
11 CNPJ F
  • Nom de la société
  • Informations sur Simples Nacional
  • Informations sur le SIMEI
  • Informations sur la Suframa
 R$0,30
12 CNPJ G
  • Nom de la société
  • Niveau de probabilité de défaut futur, selon SERASA.

Cliquez ici et lisez notre article pour plus d'informations.

 R$1,00
16 CNPJ H
  • Entrées de l'État
  • Nom de la société
 R$0,15
19 Sosie de CNPJ
  • Nom de la société
  • Courriels des membres
  • Numéros de téléphone des membres
  • WhatsApp des membres

Frais pour chaque membre qui revient.

 R$0,26

Demande de renseignements

En quelques étapes, nous allons expliquer comment la requête est effectuée par l'API CPF.CNPJ.

Après avoir généré le jeton, selon Introductionil sera nécessaire de construire l'URL de la demande.

Définition

qui contiendra le Token, ID de la Pacote et le numéro du CPF ou de la CNPJ à consulter, respectivement.

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

Paramètres de la demande

Paramètre Type Description Obligatoire ?
jeton chaîne de caractères Token généré dans le panneau de contrôle.
paquet int ID du paquet à utiliser, selon le tableau.
cpfcnpj chaîne de caractères Numéro CPF à 11 chiffres ou CNPJ à 14 chiffres.

Exemples d'URL :

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

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

Paramètres de réponse

Vérifiez ci-dessous les champs retournés pour les CPF et CNPJ.

Chaque paquet de requêtes a ses paramètres de réponse respectifs. Il faut donc s'intégrer en conséquence.

Réponses CPF

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

Paramètre Type Description
status bool 1 pour réussir et 0 en cas d'échec (voir tableau des erreurs).
cpf chaîne de caractères Numéro CPF formaté interrogé avec 14 chiffres.
nome chaîne de caractères Nom complet du titulaire (sans accents).
nomeSocial chaîne de caractères Nom social, conformément au décret 8.727/2016.
nascimento chaîne de caractères Date de naissance, format JJ/MM/AAAA.
mae chaîne de caractères Nom complet de la mère (sans accents).
genero chaîne de caractères M (Homme) ou F (Femme).
situacao chaîne de caractères Statut d'enregistrement : Regular, Cancelada, Suspensa, Pendente, Nula.
situacaoDigito chaîne de caractères Code de situation (00, 02, 03, 04, 05, 08, 09).
situacaoMotivo chaîne de caractères Raison de l'état de l'enregistrement.
situacaoAnoObito chaîne de caractères Année du décès (JJ/MM/AAAA), le cas échéant.
situacaoInscricao chaîne de caractères Date d'enregistrement auprès du bureau des impôts (JJ/MM/AAAA ou texte tel que "avant le ...").
situacaoComprovante chaîne de caractères Code de contrôle des bons en temps réel.
situacaoComprovanteEmissao chaîne de caractères Date (JJ/MM/AAAA HH:MM:SS) à laquelle la demande de renseignements a été faite auprès de la Receita Federal (temps réel).
situacaoComprovantePdf chaîne de caractères PDF de la requête faite en base64.
risco risco[] Objet de la probabilité de défaillance future (score SERASA).
endereco chaîne de caractères Adresse de résidence principale.
numero chaîne de caractères Numéro dans l'adresse.
complemento chaîne de caractères Complément d'adresse.
bairro chaîne de caractères Adresse du quartier.
cep chaîne de caractères Adresse code postal.
cidade chaîne de caractères Ville de l'adresse.
uf chaîne de caractères État (UF) avec 2 lettres.
enderecos enderecos[] Liste contenant l'historique des adresses ainsi que la plus récente (qui se trouve en dehors du tableau).
telefones telefones[] Liste contenant l'historique des numéros de téléphone possibles.
whatsapp whatsapp[] Sur la base de la liste des téléphones, un contrôle en temps réel est effectué et permet d'identifier les numéros de téléphone de WhatsApp.
emails emails[] Liste contenant l'historique des courriels possibles.
ppe ppe[] Liste des postes PPE/PEP, si vous êtes une personne politiquement exposée.
relacionados relacionados[] Liste des parents apparentés qui sont PPE/PEP.
empresas empresas[] Liste contenant la CNPJ des entreprises dans lesquelles le propriétaire est actionnaire.
pacoteUsado int ID du paquet utilisé.
saldo int Bilan du paquet après consultation.
consultaID chaîne de caractères ID de la requête (16 chiffres).
delay float Durée totale de la consultation en secondes.
Tableau des EPI

Réseau ppe[] contenant une liste des positions PPE/PEP :

Paramètre Type Description
sigla chaîne de caractères Acronyme de la fonction politique.
funcao chaîne de caractères Fonction de l'emploi.
nivel chaîne de caractères Niveau de la hiérarchie politique.
orgao chaîne de caractères Organisation.
inicioexercicio chaîne de caractères Date de début (JJ/MM/AAAA).
fimexercicio chaîne de caractères Date de fin de l'exercice financier (JJ/MM/AAAA).
fimcarencia chaîne de caractères Date de fin du délai de grâce (JJ/MM/AAAA).

Réponses de la CNPJ

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

Paramètre Type Description
status bool 1 pour réussir, 0 en cas d'échec (voir erreurs).
cnpj chaîne de caractères CNPJ formaté (18 chiffres).
razao chaîne de caractères Nom de l'entreprise.
fantasia chaîne de caractères Nom commercial de l'entreprise.
inicioAtividade chaîne de caractères Date de début des activités (JJ/MM/AAAA).
email chaîne de caractères Courriel d'enregistrement de l'entreprise.
responsavel chaîne de caractères Nom du tuteur légal (sans accents).
simplesNacional simplesNacional[] Données sur l'appartenance éventuelle à Simples Nacional.
simei simei[] Données sur une éventuelle adhésion au SIMEI.
matrizEndereco matrizEndereco[] Objet de l'adresse complète du CNPJ consulté.
matrizfilial matrizfilial[] Coordonnées de l'organisme compétent (siège/succursale).
telefones telefones[] Numéros de téléphone de l'entreprise (jusqu'à 2).
fax fax[] Fax de l'entreprise.
situacao situacao[] Statut d'enregistrement auprès de l'Internal Revenue Service.
naturezaJuridica naturezaJuridica[] Informations juridiques.
cnae cnae[] Principal CNAE.
porte porte[] Données sur la taille des entreprises.
socios socios[] QSA : partenaires/administrateurs.
risco risco[] Niveau de probabilité de défaut (SERASA).
pacoteUsado int ID du paquet utilisé.
saldo int Bilan du paquet après consultation.
consultaID chaîne de caractères ID de la requête (16 chiffres).
delay float Temps de traitement de la requête (secondes).
Objeto simplesNacional

Objet simplesNacional[] contenant des informations sur Simples Nacional :

Paramètre Type Description
optante chaîne de caractères Sim ou Não.
inicio chaîne de caractères Date de début (JJ/MM/AAAA).
fim chaîne de caractères Date de fin (JJ/MM/AAAA).
Objeto simei

Objet simei[] contenant des informations sur le SIMEI :

Paramètre Type Description
optante chaîne de caractères Sim ou Não.
anteriores matrice Objet anteriores[] avec les records précédents.
Objeto anteriores
Paramètre Type Description
inicio chaîne de caractères Date de début (JJ/MM/AAAA).
fim chaîne de caractères Date de fin (JJ/MM/AAAA).
detalhamento chaîne de caractères Description de l'enregistrement.
Objeto matrizEndereco
Paramètre Type Description
cep chaîne de caractères Code postal à 9 chiffres.
tipo chaîne de caractères Type d'adresse (par exemple, rue, avenue, etc.).
logradouro chaîne de caractères Adresse de l'entreprise.
numero chaîne de caractères Numéro dans l'adresse.
complemento chaîne de caractères Complément d'adresse.
bairro chaîne de caractères Adresse du quartier.
cidade chaîne de caractères Ville de l'adresse.
uf chaîne de caractères État (UF) avec 2 lettres.
Objeto matrizfilial

Informations sur l'organisme compétent (siège ou succursale) :

Paramètre Type Description
id int Organ ID.
tipo chaîne de caractères Corps :

id 1: Matriz
id 2: Filial
Array telefones
Paramètre Type Description
ddd chaîne de caractères Code téléphonique.
numero chaîne de caractères Numéro de téléphone.
Objeto fax
Paramètre Type Description
ddd chaîne de caractères DDD du fax.
numero chaîne de caractères Numéro de fax.
Objeto situacao
Paramètre Type Description
id int Identification de la situation cadastrale.
nome chaîne de caractères Nom de la situation, par exemple :

id 1: Baixada
id 2: Ativa
id 3: Suspensa
id 4: Inapta
id 8: Baixada
data chaîne de caractères Date de la situation (JJ/MM/AAAA).
Objeto naturezaJuridica

Objet naturezaJuridica[] avec des précisions sur la nature juridique.
Liste officielle

Paramètre Type Description
codigo chaîne de caractères Code de nature juridique (4 chiffres).
descricao chaîne de caractères Description de la nature juridique.
Objeto cnae

Objet cnae[] avec les données de la CNAE principale.
Table CNAE

Paramètre Type Description
divisao chaîne de caractères Code de la division.
grupo chaîne de caractères Code du groupe.
classe chaîne de caractères Code de classe.
subClasse chaîne de caractères Code de sous-classe.
fiscal chaîne de caractères Code CNAE complet (chiffres uniquement).
descricao chaîne de caractères Description de la CNAE.
Objeto porte

Objet porte[] contenant des données sur la taille de l'entreprise.

Paramètre Type Description
id chaîne de caractères ID du port.
descricao chaîne de caractères Description de la taille, par exemple :

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

Objet socios[] contenant des données QSA :

Paramètre Type Description
nome chaîne de caractères Nom du partenaire PF ou PJ (sans accentuation).
cnpj chaîne de caractères CNPJ formaté, si partenaire.
tipo chaîne de caractères Type de partenaire.
capitalSocial float Pourcentage du capital social.
pais chaîne de caractères Le pays d'origine du partenaire.
Objeto risco

Objet risco[] avec les données du score SERASA :

Paramètre Type Description
nivel int Niveau de risque ID (0 à 4).
descricao chaîne de caractères Description du niveau : inconnu, faible, moyen, élevé, très élevé.
score chaîne de caractères Fourchette de scores associée au niveau.

Soldes de chèques

Vérifiez gratuitement le solde du forfait souhaité.

Définition

qui contiendra le jeton et le paquetrespectivement.

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

Paramètres de la demande

Paramètre Type Description Obligatoire ?
token chaîne de caractères Token généré dans le panneau de contrôle.
pacote int ID du paquet (voir tableau).

Paramètres de réponse

Objet pacote[] avec des informations sur le solde :

Paramètre Type Description
id int ID du paquet.
nome chaîne de caractères Nom du paquet.
saldo int Solde disponible.

Codes d'erreur

Liste des erreurs renvoyées dans les paramètres erro e 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 informé comporte moins de 11 chiffres.
102
 CPF O CPF informado não existe (...) CPF valide, mais non répertorié dans la base de données 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 informé a moins de 14 chiffres.
202
 CNPJ O CNPJ informado não existe (...) CNPJ valide, mais non répertorié dans les bases de données de l'administration fiscale.
1000
 CPF/CNPJ Token inválido! (...) Le jeton n'appartient pas à l'IP source.
1001
 CPF/CNPJ Créditos insuficientes! Pas de crédits dans le paquet sélectionné.
1002
 CPF/CNPJ Conta suspensa e/ou inativa! Contacter le support.
1003
 CPF/CNPJ Blacklist até *DATA* IP et jeton temporairement suspendus.
1004
 CPF/CNPJ Pacote indisponível para consultas! L'identifiant du paquet n'est pas valide ou n'est pas disponible.
1005
 CPF/CNPJ Não é possível consultar *CPF/CNPJ* neste pacote! Défaillance 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.