API de consulta de CPF con datos oficiales
Envía el CPF y la fecha de nacimiento y recibe nombre, situación de registro y fecha de inscripción en un JSON estándar. Lo que no coincide con la base oficial vuelve como no encontrado, sin gastar crédito.
Plan gratuito con 20 consultas al mes. Sin tarjeta de crédito.
Resultado de la consulta
- CPF
- 529.982.247-25
- Nombre
- MARIA SOUZA LIMA
- Nacimiento
- 26/11/1982
- Situación
- REGULAR
Qué devuelve la consulta
Los datos de registro del CPF, listos para confirmar quién es tu cliente.
- Nombre y nombre social
- Nombre completo del titular y, cuando existe, el nombre social registrado.
- Situación de registro
- Regular, suspendida, pendiente de regularización, cancelada de oficio o nula, como la publica la Receita Federal.
- Fecha de nacimiento
- Devuelta como texto y también separada en día, mes y año, para validar la mayoría de edad sin conversión.
- Fecha de inscripción
- Cuándo se inscribió el CPF en la Receita Federal, útil para detectar registros muy recientes.
- CPF y nacimiento verificados juntos
- La consulta solo devuelve datos cuando el CPF y la fecha de nacimiento coinciden, lo que desalienta el uso de CPF ajenos.
- Respuesta estándar
- El mismo formato en todas las consultas, con los créditos restantes si quieres mostrarlos.
Cómo funciona
- 1
Validación local
Antes de cualquier búsqueda comprobamos el formato y los dígitos verificadores. Un CPF inválido vuelve con error 422 y no gasta crédito.
- 2
Respuesta rápida
Los CPF consultados recientemente responden en milisegundos, al mismo precio que una consulta nueva.
- 3
Fuente oficial
Cuando hace falta, consultamos la base oficial y devolvemos el resultado ya estandarizado.
Una llamada, un JSON
Autentícate con el encabezado x-api-key y envía el CPF y la fecha de nacimiento.
Documentación del endpointcURL POST /v1/cpf
Respuesta
Consulta completada con éxito.
CPF no encontrado en la base oficial.
Cuánto cuesta
1 crédito por consulta exitosa
Solo la respuesta 200 consume crédito. CPF inválido, no encontrado, errores de autenticación e indisponibilidad no cobran nada.
Sandbox sin costo
Las claves de sandbox (brz_test_) responden con datos de prueba y nunca debitan el saldo. Úsalas para integrar sin gastar créditos.
Excedente sin interrupción
En los planes de pago la API sigue respondiendo después de la franquicia, al precio de excedente de tu plan. En el plan gratuito se detiene al agotarse.
Dónde usarlo
Registro y onboarding
Confirma el nombre y la situación del CPF antes de abrir la cuenta y rechaza registros con datos que no coinciden.
Verificación de mayoría de edad
Usa la fecha de nacimiento oficial para liberar productos y servicios restringidos a mayores de 18 años.
Antifraude y crédito
Cruza el CPF informado con la base oficial antes de aprobar una compra o un análisis de crédito.
Preguntas frecuentes
¿Tengo que enviar la fecha de nacimiento?
Sí. La consulta exige el CPF y la fecha de nacimiento (AAAA-MM-DD). Si los dos no coinciden con la base oficial, la respuesta es 404 y no se cobra nada.
¿De dónde vienen los datos?
De la base oficial del CPF en la Receita Federal, consultada mediante un proveedor autorizado. BrazID estandariza la respuesta y guarda un historial de consultas recientes para responder más rápido.
¿Qué pasa con un CPF inválido?
Si el formato es incorrecto la API responde 400; si los dígitos verificadores no coinciden, 422. En ambos casos no se consulta ninguna base ni se gasta crédito. Para solo comprobar el número, usa el validador gratuito.
¿Puedo probar sin gastar créditos?
Sí. El sandbox (api-sandbox.brazid.com) responde con CPF de prueba en varios escenarios y no debita el saldo. También hay una colección de Insomnia lista para importar.
¿Cuántas solicitudes por segundo?
Depende del plan: 5 req/s en el gratuito y 20, 50 y 100 en los de pago. Al superar el límite la API responde 429 con el encabezado Retry-After.
Otros productos de BrazID
Todos usan la misma clave de API y el mismo saldo de créditos.
Valida CPF con datos oficiales
Crea tu cuenta, genera una clave de sandbox y haz tu primera consulta de CPF en minutos.
Plan gratuito con 20 consultas al mes. Sin tarjeta de crédito.