Skip to main content
GET
Get Bulk Status

Overview

Retrieve the processing status and summary statistics of a bulk verification request. This endpoint provides aggregated information about the bulk, including:
  • Total number of submitted items
  • Number of completed verifications
  • Number of rejected items
  • Number of failed items
  • Number of items still in progress

Bulk Status Values

  • accepted – The bulk has been received and is queued for processing.
  • processing – Items are currently being processed.
  • completed – All items have reached a final state.
An item reaches a final state when its status is either:
  • completed
  • failed
  • rejected
Use the bulk items endpoint to retrieve individual verification results.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Response

200 - application/json

Bulk status

id
string<uuid>
status
enum<string>
Available options:
accepted,
processing,
completed
total_items
integer
completed_items
integer
failed_items
integer
in_progress_items
integer
rejected_items
integer
created_at
string<date-time>