Quick Verification

Bulk Email — Fetch results (step 2 of 2)

Check results for a batch using its identifier.

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

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

Request body

identifierstring required

The identifier returned by the submit endpoint. The API generates this — you do not create it.

Example request

{
  "identifier": "batch_sample_a1b2c3d4"
}

Response

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

status'completed' | 'processing'

processing = still running, poll again. completed = all results are final, stop polling.

identifierstring

The batch identifier you submitted.

retry_after_secondsinteger

Suggested seconds to wait before polling again.

resultsobject

Each email mapped to its result. Shows pending until the batch is completed.

Example response

{
  "status": "completed",
  "identifier": "batch_sample_a1b2c3d4",
  "retry_after_seconds": 86400,
  "results": {
    "john.doe@company.com": {
      "result": "Valid",
      "status": "OK",
      "quick_status": "OK"
    },
    "jane.smith@agency.com": {
      "result": "Invalid",
      "status": "HARD_BOUNCE",
      "quick_status": "HARD_BOUNCE"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.