API de Validation de CPF et CNPJ
Chez CPF.CNPJ, nous simplifions et accélérons l'accès aux informations essentielles des personnes physiques et morales.
Pourquoi valider CPF et CNPJ va au-delà du chiffre de contrôle
Valider uniquement le chiffre de contrôle d’un CPF ou CNPJ ne suffit pas. Le chiffre de contrôle (calculé par modulo 11) confirme seulement que la séquence de chiffres est formellement valide — il ne garantit pas que le document existe réellement ni qu’il est régulier. Il est possible de générer des milliers de CPF et CNPJ avec des chiffres de contrôle corrects qui n’ont jamais été émis par la Receita Federal.
C’est pourquoi les enregistrements frauduleux passent facilement par des validations qui vérifient seulement la structure du numéro. Un formulaire qui accepte n’importe quel CPF avec un chiffre valide permet aux fraudeurs de créer des comptes en masse, de contourner les limites par client et de polluer la base de données avec des identités inexistantes. Pour la prévention de la fraude et l’antifraude, la seule approche fiable est de vérifier la situation d’enregistrement réelle du document à la source officielle.
La validation complète combine deux couches : la validation formelle (chiffre de contrôle, en millisecondes, sans coût de consultation) et la vérification d’enregistrement auprès de la Receita Federal (situation Regular, Cancelado, Suspenso, Nulo pour CPF ; Ativa, Baixada, Inapta, Suspensa pour CNPJ). Seule la somme des deux couches garantit que le document existe et est apte à opérer.
Ce que livre l’API de Validation de CPF et CNPJ
1. Validation du chiffre de contrôle instantanée (modulo 11)
L’API valide la structure du CPF et du CNPJ en utilisant l’algorithme de modulo 11, le même standard défini par la Receita Federal pour le calcul des chiffres de contrôle. Cette vérification formelle est instantanée et a lieu avant toute consultation d’enregistrement, écartant immédiatement les numéros mal formés, répétés (comme 000.000.000-00) ou saisis incorrectement.
2. Vérification de la situation d’enregistrement réelle auprès de la Receita Federal
Au-delà du chiffre de contrôle, l’API consulte la situation d’enregistrement officielle du document. Pour CPF, elle retourne s’il est Regular, Suspenso, Cancelado, En attente de Régularisation ou Nulo. Pour CNPJ, elle retourne la situation (Ativa, Baixada, Inapta, Suspensa) avec la raison sociale, la date d’ouverture et les autres données d’enregistrement. C’est cette couche qui distingue un document valide sur le papier d’un document réellement existant et apte.
3. Prise en charge de CPF et CNPJ, y compris le CNPJ alphanumérique de 2026
L’API valide aussi bien le CPF que le CNPJ par le même endpoint, identifiant automatiquement le type de document. La prise en charge inclut le nouveau format de CNPJ alphanumérique, dont l’émission est prévue à partir de 2026 : les huit premiers caractères de la racine et les quatre de l’ordre peuvent contenir des lettres et des chiffres, tout en conservant les deux chiffres de contrôle numériques, calculés en modulo 11 sur les valeurs ASCII des caractères.
4. Réponse REST/JSON en temps réel
L’intégration se fait par une API REST qui répond en JSON, prête à être appelée depuis n’importe quel langage ou plateforme. L’authentification se fait par token, sans captcha et sans besoin de date de naissance. La réponse en temps réel permet de valider des documents directement dans le flux d’inscription, de checkout ou d’onboarding, sans bloquer l’expérience de l’utilisateur.
Comment intégrer l’API de validation
L’intégration est directe : authentifiez-vous avec votre token et envoyez le CPF ou CNPJ au endpoint de validation. L’exemple ci-dessous valide un CPF et un CNPJ via cURL et retourne la situation d’enregistrement en JSON.
# Validar um CPF
curl -X POST "https://api.cpfcnpj.com.br/SEU_TOKEN/2/json/cpf" \
-H "Content-Type: application/json" \
-d '{"cpf": "00000000000"}'
# Resposta (JSON)
# {
# "cpf": "000.000.000-00",
# "nome": "NOME COMPLETO",
# "situacao": "REGULAR"
# }
# Validar um CNPJ (inclui CNPJ alfanumérico)
curl -X POST "https://api.cpfcnpj.com.br/SEU_TOKEN/9/json/cnpj" \
-H "Content-Type: application/json" \
-d '{"cnpj": "00000000000000"}'
# Resposta (JSON)
# {
# "cnpj": "00.000.000/0000-00",
# "razao_social": "EMPRESA EXEMPLO LTDA",
# "situacao_cadastral": "ATIVA",
# "data_abertura": "2015-01-01"
# }Les paramètres complets, les codes de retour et les exemples dans d’autres langages sont dans la documentation officielle sur https://www.cpfcnpj.com.br/dev/. L’inscription est gratuite et débloque des crédits pour des tests immédiats.
Pourquoi utiliser l’API de Validation de CPF et CNPJ
- Latence faible (0,4-2s): Validation formelle en millisecondes et consultation d’enregistrement en quelques secondes
- Uptime de 99,9%: Infrastructure surveillée pour une validation continue en production
- Validation formelle + enregistrement: Chiffre de contrôle (modulo 11) et situation réelle auprès de la Receita Federal
- Couverture CPF et CNPJ: Même endpoint pour CPF et CNPJ, y compris le CNPJ alphanumérique de 2026
