---
title: "Retrieve bulk email verification results in JSON format"
method: GET
path: "/v1/verify/bulk/dump"
tags: ["Bulk verification"]
---

# Retrieve bulk email verification results in JSON format

`GET /v1/verify/bulk/dump`

## Request

- Base URL: `https://api.bounceban.com`
- URL: `https://api.bounceban.com/v1/verify/bulk/dump`
- Auth: API key in header `Authorization`

Retrieve verification results for a bulk email verification task using a task ID in JSON format. Results are available within 90 days of verification.<br><br> When making a request with the `state` parameter included, you might not receive all the verified results if the task is not yet finished. To obtain a comprehensive list of the verified emails that have been processed so far, you should omit the `state` parameter from your request.

## Query parameters

- `id` string, required
- `state` '' | 'deliverable' | 'risky' | 'undeliverable' | 'unknown'
- `cursor` string
- `page_size` integer
- `retrieve_all` '' | '1'

## Response `200`

Indicates the request is successful.

- object
  - `result` 'ok' | 'err': > `ok` Indicates the request is successful.<br> > `err` The bulk task has not finished yet, please try again later.
  - `status` 'importing' | 'verifying' | 'finished': Bulk email verification task status. > `importing` indicates the list of emails are being imported for verification.<br> > `verifying` indicates all the emails are imported and are being verified.<br> > `finished` indicates verification for the whole list has finished.
  - `cursor` string: Use this value to retrieve next page.
  - `items` BulkVerifyResult[]: Detailed verification results for each email.
    - `status` 'success' | 'verifying' | 'queue': Verification status for this task. > `success` indicates the task is finished and the final verification result can be returned.<br> > `verifying` indicates the email is still being verified.<br> > `queue` indicates the email is still being in queue.
    - `email` string: The email address submitted for verification.
    - `result` 'deliverable' | 'risky' | 'undeliverable' | 'unknown': The state (verification result) for the email.
    - `score` integer: The score (0 ~ 100) represents the deliverability of an email - the higher, the better.
    - `is_disposable` boolean: Whether the email is disposable.
    - `is_accept_all` boolean: Whether the email is accept-all.
    - `is_role` boolean: Whether the email is role based.
    - `is_free` boolean: Whether the email is a free email.
    - `mx_records` string[]: All MX records for the email.
    - `smtp_provider` string: SMTP provider based on the main MX record, e.g. if the MX record for an email is `alt1.aspmx.l.google.com`, then the smtp provider will be `Google`.
    - `mode` string: Verification mode.
    - `verify_at` unknown

## Other responses

- `400`: Invalid parameter.
- `401`: Authorization information is missing or invalid.
- `405`: The account is blocked.
- `429`: Rate limited.
- `500`: Unexpected error.

---

[API](https://skmtc.dev/bounceban/apis/bounceban-apis-reference.md) - [All operations](https://skmtc.dev/bounceban/apis/bounceban-apis-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/bounceban/apis/bounceban-apis-reference/revisions/0f9b503568c3?raw)