---
title: "Request verification results for emails from a bulk verification task."
method: POST
path: "/v1/verify/bulk/emails"
tags: ["Bulk verification"]
---

# Request verification results for emails from a bulk verification task.

`POST /v1/verify/bulk/emails`

## Request

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

To retrieve verification results for specific emails from your bulk verification task, provide the task ID along with the chosen email addresses.

## Request body

- object
  - `id` string: (Required) Bulk email verification task ID.
  - `emails` string[]: Specify the list of emails to retrieve verification results, with a maximum limit of 100 emails. Include only emails from the bulk verification task associated with the given task ID.

## 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.
  - `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)