API de Consultation de CPF auprès de la Receita Federal
Chez CPF.CNPJ, nous simplifions et accélérons l'accès aux informations essentielles des personnes physiques et morales.
Pourquoi consulter le CPF directement auprès de la Receita Federal
Le CPF est l'identifiant officiel des personnes physiques au Brésil, mais le numéro, à lui seul, ne prouve rien : des chiffres valides dans l'algorithme de vérification ne signifient pas que le CPF existe, soit régulier ou appartienne à la personne indiquée. Sans consulter la base de la Receita Federal, les entreprises acceptent des inscriptions avec un CPF inexistant, de tiers ou en situation irrégulière, ouvrant une brèche pour la fraude d'identité, la fraude documentaire et le non-respect des obligations de prévention des fraudes lors de l'onboarding.
La consultation renvoie la situation d'enregistrement du CPF, qui peut être Régulière, En attente de Régularisation, Suspendue, Annulée, Nulle ou indiquer un Titulaire Décédé. Chaque situation a un effet pratique : un CPF Suspendu ou En attente empêche l'émission de factures et les contractations ; un CPF Annulé ou d'un titulaire décédé utilisé dans une nouvelle inscription est un fort indice de fraude. Valider cette situation avant d'approuver le client est ce qui sépare un onboarding sûr d'un passif de fraude et de compliance.
Faire cela manuellement ne passe pas à l'échelle. Les équipes qui traitent des milliers d'inscriptions par jour ne peuvent pas vérifier CPF par CPF sur le site de la Receita, qui exige encore un captcha et n'offre aucune réponse programmatique. Une API de consultation de CPF résout le goulot d'étranglement : elle intègre la vérification directement dans le flux d'inscription, renvoie la situation d'enregistrement en temps réel et permet d'automatiser la décision d'approuver, de rejeter ou d'envoyer le cas en révision humaine.
Ce que fournit l'API de Consultation de CPF
1. Nom et situation d'enregistrement officiels
L'API renvoie le nom complet du titulaire et la situation d'enregistrement du CPF exactement comme ils figurent dans la base de la Receita Federal : Régulière, En attente de Régularisation, Suspendue, Annulée, Nulle ou Titulaire Décédé. Avec ces données, vous confrontez le nom déclaré par le client au nom officiel et bloquez automatiquement les CPF qui ne sont pas réguliers.
2. Date de naissance selon autorisation
Lorsque le forfait souscrit et les règles d'utilisation le permettent, la réponse inclut la date de naissance associée au CPF. Cela rend possibles des vérifications supplémentaires telles que le contrôle de la majorité (18+) et le cross-matching de la date déclarée contre la date officielle, renforçant la prévention de la fraude d'identité synthétique.
3. Réponse en temps réel (D+0)
La consultation est effectuée à la source officielle et répond en temps réel, sans cache obsolète. La situation d'enregistrement reflétée est celle du moment de la consultation (D+0), garantissant que les décisions d'onboarding utilisent l'état actuel du CPF et non un instantané ancien.
4. REST/JSON avec authentification par token
L'intégration est une API REST qui renvoie du JSON, authentifiée par un token envoyé dans l'en-tête de la requête. Pas de captcha, pas de dépendance à un écran du gouvernement : un simple appel HTTP depuis votre backend renvoie les données structurées à traiter dans votre flux.
Comment intégrer la Consultation de CPF
La consultation est un appel HTTP GET authentifié par token Bearer. Envoyez le CPF en paramètre et recevez la situation d'enregistrement en JSON. Exemple avec cURL :
# Consulta de CPF na Receita Federal via API
curl -X GET "https://api.cpfcnpj.com.br/SEU_TOKEN/9/12345678909" \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Accept: application/json"
# Resposta (JSON)
{
"status": 1,
"cpf": "123.456.789-09",
"nome": "JOSE DA SILVA",
"situacao_cadastral": "REGULAR",
"data_nascimento": "1990-05-14",
"data_consulta": "2026-06-02T10:32:11Z"
}Traitez le champ situacao_cadastral dans votre backend : approuvez uniquement les CPF REGULAR, bloquez CANCELADA, NULA et TITULAR FALECIDO, et envoyez PENDENTE ou SUSPENSA en révision. La référence complète des endpoints, forfaits et codes de retour est disponible sur https://www.cpfcnpj.com.br/dev/.
À quoi s'attendre de l'API de Consultation de CPF
- Faible latence: Réponse moyenne entre 0,4 et 2 secondes par consultation de CPF
- Uptime 99,9%: Disponibilité du service pour intégrer la consultation dans votre onboarding
- Source officielle Receita Federal: Situation d'enregistrement consultée dans la base officielle, sans donnée intermédiaire
- Couverture nationale: Consultation de tout CPF émis au Brésil, en temps réel (D+0)
