API de Validación de CPF y CNPJ
En CPF.CNPJ, simplificamos y agilizamos el acceso a información esencial de personas físicas y jurídicas.
Por qué validar CPF y CNPJ va más allá del dígito verificador
Validar únicamente el dígito verificador de un CPF o CNPJ no es suficiente. El dígito verificador (calculado por módulo 11) confirma solamente que la secuencia de números es formalmente válida — no garantiza que el documento realmente exista ni que esté regular. Es posible generar miles de CPF y CNPJ con dígitos verificadores correctos que nunca fueron emitidos por la Receita Federal.
Por eso, los registros falsos pasan fácilmente por validaciones que comprueban solo la estructura del número. Un formulario que acepta cualquier CPF con dígito válido permite que los defraudadores creen cuentas en masa, burlen los límites por cliente y contaminen la base de datos con identidades inexistentes. Para la prevención del fraude y antifraude, el único enfoque confiable es comprobar la situación registral real del documento en la fuente oficial.
La validación completa combina dos capas: la validación formal (dígito verificador, en milisegundos, sin costo de consulta) y la comprobación registral en la Receita Federal (situación Regular, Cancelado, Suspenso, Nulo para CPF; Activa, Baja, Inapta, Suspensa para CNPJ). Solo la suma de las dos capas garantiza que el documento existe y está apto para operar.
Qué entrega la API de Validación de CPF y CNPJ
1. Validación de dígito verificador instantánea (módulo 11)
La API valida la estructura del CPF y del CNPJ usando el algoritmo de módulo 11, el mismo estándar definido por la Receita Federal para el cálculo de los dígitos verificadores. Esta comprobación formal es instantánea y ocurre antes de cualquier consulta registral, descartando de inmediato números mal formados, repetidos (como 000.000.000-00) o digitados incorrectamente.
2. Comprobación de situación registral real en la Receita Federal
Además del dígito verificador, la API consulta la situación registral oficial del documento. Para CPF, devuelve si está Regular, Suspenso, Cancelado, Pendiente de Regularización o Nulo. Para CNPJ, devuelve la situación (Activa, Baja, Inapta, Suspensa) junto a razón social, fecha de apertura y demás datos registrales. Es esa capa la que diferencia un documento válido en el papel de un documento realmente existente y apto.
3. Soporte para CPF y CNPJ, incluyendo el CNPJ alfanumérico de 2026
La API valida tanto CPF como CNPJ por el mismo endpoint, identificando automáticamente el tipo de documento. El soporte incluye el nuevo formato de CNPJ alfanumérico, cuya emisión está prevista a partir de 2026: los ocho primeros caracteres de la raíz y los cuatro del orden pueden contener letras y números, manteniendo los dos dígitos verificadores numéricos, calculados en módulo 11 sobre los valores ASCII de los caracteres.
4. Respuesta REST/JSON en tiempo real
La integración se hace mediante una API REST que responde en JSON, lista para ser llamada desde cualquier lenguaje o plataforma. La autenticación es por token, sin captcha y sin necesidad de fecha de nacimiento. La respuesta en tiempo real permite validar documentos directamente en el flujo de registro, checkout u onboarding, sin trabar la experiencia del usuario.
Cómo integrar la API de validación
La integración es directa: autentícate con tu token y envía el CPF o CNPJ al endpoint de validación. El ejemplo de abajo valida un CPF y un CNPJ vía cURL y devuelve la situación registral 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"
# }Los parámetros completos, códigos de retorno y ejemplos en otros lenguajes están en la documentación oficial en https://www.cpfcnpj.com.br/dev/. El registro es gratuito y libera créditos para pruebas inmediatas.
Por qué usar la API de Validación de CPF y CNPJ
- Latencia baja (0,4-2s): Validación formal en milisegundos y consulta registral en pocos segundos
- Uptime del 99,9%: Infraestructura monitoreada para validación continua en producción
- Validación formal + registral: Dígito verificador (módulo 11) y situación real en la Receita Federal
- Cobertura CPF y CNPJ: Mismo endpoint para CPF y CNPJ, incluyendo CNPJ alfanumérico de 2026
