Skip to main content
Reads one page of a bulk job’s results. Charged: Free.

Inputs

What comes back

A page with job_id, total_rows, total_processed, results and next_offset. total_rows is the job’s size (each address counted once), not the rows on this page. In results, each row is one address with its status, substatus, explanation and provider, as from validate_email; GET /v1/bulk//results has the full row reference.

Reading every row

Start at offset 0 and send each page’s next_offset as the next offset. It is null on the last page. A page can hold fewer rows than limit when its rows are large; next_offset still points at the first row not yet sent, so no row is skipped or repeated. If the job has not finished, the call returns job_not_ready; check get_bulk_validation_status first.