---
title: "Bulk Email — Fetch results (step 2 of 2)"
method: POST
path: "/fetch_bulk_results"
tags: ["Quick Verification"]
---

# Bulk Email — Fetch results (step 2 of 2)

`POST /fetch_bulk_results`

## Request

- Base URL: `https://api.scrubby.io`
- URL: `https://api.scrubby.io/fetch_bulk_results`
- Auth: API key in header `x-api-key`

Check results for a batch using its `identifier`.

Poll every 30-60 seconds. When `status` is `completed`, all results are final — stop polling.

## Request body

- FetchBulkResultsRequest
  - `identifier` string, required: The identifier returned by the submit endpoint. The API generates this — you do not create it.

## Response `200`

Check the `status` field. `processing` = poll again in 30-60s. `completed` = done, stop polling.

- FetchResultResponse
  - `status` 'completed' | 'processing': `processing` = still running, poll again. `completed` = all results are final, stop polling.
  - `identifier` string: The batch identifier you submitted.
  - `retry_after_seconds` integer: Suggested seconds to wait before polling again.
  - `results` object: Each email mapped to its result. Shows `pending` until the batch is `completed`.

## Other responses

- `404`: Identifier not found.
- `429`: Rate limit hit (25 requests/second). Wait a moment and retry.

---

[API](https://skmtc.dev/scrubby/apis/scrubby-email-validation-api.md) - [All operations](https://skmtc.dev/scrubby/apis/scrubby-email-validation-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scrubby/apis/scrubby-email-validation-api/revisions/506f3f7eee4c?raw)