Consulta de CPF por lotes: hasta 1.000 CPF por envío
Envía la lista completa en una llamada y sigue el avance o recibe un aviso por webhook al terminar. Ideal para depurar bases y revisar registros en masa.
Solo los CPF encontrados consumen crédito. Sandbox sin costo.
Avance del lote
- Total
- 1.000 CPF
- Procesados
- 1.000
- Encontrados
- 968
- No encontrados
- 32
Hecho para volumen
La misma consulta oficial de CPF, sin tener que controlar miles de llamadas.
- Hasta 1.000 CPF por envío
- Cada ítem lleva el CPF y la fecha de nacimiento. Los CPF repetidos en la lista cuentan una vez.
- Procesamiento asíncrono
- La API responde 202 al instante con un batch_id y procesa la lista en segundo plano, sin bloquear tu aplicación.
- Aviso por webhook
- Registra un webhook y recibe el evento batch.completed al terminar, solo con contadores y fechas, sin datos personales.
- Resultados paginados
- Cada ítem vuelve con un estado (encontrado, no encontrado, inválido o error) y, si se encontró, los datos del CPF.
- Reintenta solo lo que falló
- Los ítems inválidos, no encontrados o con falla del proveedor no se cobran, y reenvías solo esos.
- Las mismas reglas de la consulta individual
- El mismo saldo, el mismo límite de solicitudes del plan y la misma respuesta por ítem.
Cómo funciona
- 1
Envías la lista
La API valida cada ítem y reserva el procesamiento. La respuesta 202 trae el batch_id.
- 2
Resolvemos en segundo plano
Lo consultado recientemente se resuelve al instante. El resto va a la fuente oficial.
- 3
Sigues el avance y lees los resultados
Consulta el avance hasta que el estado sea completed, o espera el webhook. Los resultados quedan disponibles 24 horas.
Envía la lista, sigue el avance después
Un POST con la lista de CPF y fechas de nacimiento devuelve el batch_id para seguir el lote.
Documentación del endpointcURL POST /v1/cpf/batch
Respuesta
Lote aceptado. Síguelo con su batch_id.
Saldo insuficiente para cubrir el lote: no se procesó nada.
Cuánto cuesta
1 crédito por CPF encontrado
Los ítems inválidos, no encontrados y las fallas del proveedor no se cobran. El saldo debe cubrir todo el lote, salvo que tu plan permita excedente.
Sandbox sin costo
En el sandbox el lote corre con CPF de prueba, incluido un lote mixto de ejemplo, sin debitar créditos.
El mismo saldo de las demás consultas
Los créditos del plan valen para CPF, CNPJ, lotes y dossier. El lote respeta el límite de solicitudes de la cuenta.
Dónde usarlo
Depuración de bases
Revisa miles de registros a la vez y encuentra CPF suspendidos, cancelados o con datos que no coinciden.
Migración de sistemas
Valida todo el padrón antes de importar clientes a una nueva plataforma.
Cobranza y recuperación
Actualiza la situación de registro de una cartera completa en una sola pasada.
Preguntas frecuentes
¿Cuál es el tamaño máximo del lote?
Hasta 1.000 ítems por envío. Para listas mayores, envía varios lotes en secuencia; cada cuenta tiene un tope de ítems en espera de procesamiento para proteger la cola.
¿Cuánto tarda un lote?
Depende del tamaño y de cuántos CPF se consultaron recientemente. Sigue el estado del lote o recibe el webhook batch.completed al terminar.
¿Cuánto tiempo quedan disponibles los resultados?
24 horas después del envío. Luego el lote desaparece y hay que consultar de nuevo.
¿Quién paga los CPF que no se encontraron?
Nadie: solo los CPF encontrados consumen crédito. Los inválidos, no encontrados y las fallas del proveedor no se cobran.
¿Y si mi saldo se acaba a mitad del lote?
La API revisa el saldo antes de empezar y responde 402 si no cubre el lote (salvo que tu plan permita excedente). Un lote nunca empieza a medias.
Otros productos de BrazID
Todos usan la misma clave de API y el mismo saldo de créditos.
Revisa miles de CPF a la vez
Crea tu cuenta, prueba el lote en el sandbox y procesa tu base con la clave de producción.
Solo los CPF encontrados consumen crédito. Sandbox sin costo.