Consulta de CPF por lotes

Envía hasta 1.000 CPF a la vez. El procesamiento es asíncrono: la API responde 202 con un batch_id y usted sigue el avance o espera el webhook.

Cuerpo de la solicitud

[]arrayobligatorio

Lista de 1 a 1.000 elementos. Los CPF repetidos cuentan una vez.

[].cpfstringobligatorio

CPF, con o sin puntuación.

[].birthdatestringobligatorio

Fecha de nacimiento, AAAA-MM-DD.

1 crédito por elemento encontrado.

• El saldo debe cubrir todo el lote, salvo que su plan permita excedente. Sin saldo, la respuesta es 402 y el lote no empieza.
• Los elementos inválidos, no encontrados y las fallas del proveedor no se cobran. Puede reenviar solo los que fallaron.

Cómo se procesa el lote

1. 1

   Usted envía la lista

   La API valida cada elemento y encola el trabajo. La respuesta 202 trae el batch_id.

2. 2

   Respuestas rápidas

   Lo que se consultó recientemente se resuelve de inmediato. El resto va a la fuente oficial en segundo plano.

3. 3

   Usted sigue el avance

   Consulte GET /v1/cpf/batch/{id} hasta que el estado sea completed, o reciba el evento batch.completed en su webhook.

4. 4

   Usted lee los resultados

   Los resultados salen paginados y quedan disponibles por 24 horas.

Campos de la respuesta 202

batch_idstring

Identificador del lote. Úselo para seguir el avance.

statusstring

processing o completed.

totalnumber

Cantidad de elementos del lote.

processednumber

Elementos ya resueltos.

found / not_found / invalid / errorsnumber

Contadores por resultado hasta el momento.

status_urlstring

Ruta para seguir el lote. También viene en el encabezado Location.

credits_remainingnumber

Saldo tras los elementos ya cobrados. Se puede ocultar en el panel.