---
title: "Get bulk email verification status"
method: GET
path: "/v1/verify/bulk/status"
tags: ["Bulk verification"]
---

# Get bulk email verification status

`GET /v1/verify/bulk/status`

## Request

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

You can use this API to get the latest progress and stats for a bulk email verification task using a task ID.

## Query parameters

- `id` string, required

## Response `200`

Indicates the request is successful.

- object
  - `id` string: Bulk email verification task id.
  - `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.
  - `total_count` integer: If `status` is `importing` or `verifying`, it represents the number of emails for verification; If `status` is `finished`, it represents the number of emails verified.
  - `finished_count` integer: It represents the number of emails imported when `status` is `importing`, and the number of emails verified when `status` is `verifying`.
  - `pushed_count` integer: It represents the number of emails pushed via webhook events. Only returned when `status` is `verifying` or `finished`, and a webhook was submitted when creating the bulk verification task.
  - `deliverable_count` integer: It represents the number of emails that are `deliverable`. Only returned when `status` is `finished`.
  - `undeliverable_count` integer: It represents the number of emails that are `undeliverable`. Only returned when `status` is `finished`.
  - `risky_count` integer: It represents the number of emails that are `risky`. Only returned when `status` is `finished`.
  - `unknown_count` integer: It represents the number of emails that are `unknown`. Only returned when `status` is `finished`.
  - `catchall_count` integer: It represents the number of emails that are `catchall`. Only returned when `status` is `finished`.
  - `credits_consumed` number, float: Credits consumed for this task. Only returned when `status` is `finished`.
  - `credits_remaining` number, float: Credits remaining after this task. `-1` means unlimited. Only returned when `status` is `finished`.

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