Bulk verification

Get bulk email verification status

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

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

Query parameters

idstring required

Bulk email verification task id.

Response

Indicates the request is successful.

idstring

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_countinteger

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_countinteger

It represents the number of emails imported when status is importing, and the number of emails verified when status is verifying.

pushed_countinteger

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_countinteger

It represents the number of emails that are deliverable. Only returned when status is finished.

undeliverable_countinteger

It represents the number of emails that are undeliverable. Only returned when status is finished.

risky_countinteger

It represents the number of emails that are risky. Only returned when status is finished.

unknown_countinteger

It represents the number of emails that are unknown. Only returned when status is finished.

catchall_countinteger

It represents the number of emails that are catchall. Only returned when status is finished.

credits_consumednumber float

Credits consumed for this task. Only returned when status is finished.

credits_remainingnumber float

Credits remaining after this task. -1 means unlimited. Only returned when status is finished.

Changes

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