> ## Documentation Index
> Fetch the complete documentation index at: https://orbisearch.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# get_bulk_validation_results

> Read a bulk job's results, one page at a time.

Reads one page of a bulk job's results.

**Charged:** Free.

## Inputs

| Input | Required | Description |
| - | - | - |
| `job_id` | Yes | The job id returned at submit. |
| `limit` | No | Rows per page (1-100). Default 100. |
| `offset` | No | Row to start from, counted from 0. Use next\_offset from the previous page. |

## 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/{job_id}/results](https://orbisearch.com/docs/api-reference/bulk-results.md) 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`](https://orbisearch.com/docs/mcp/tools/get-bulk-validation-status) first.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.