Skip to main content
GET
Get Bulk Items

Overview

Retrieve the individual results of a bulk verification request. Results are returned in a paginated format. Each item corresponds to one verification submitted in the original bulk request.

Item Status Values

  • pending – The verification is still being processed.
  • completed – The verification was successfully processed.
  • failed – The financial institution could not process the verification.
  • rejected – The item was invalid (e.g., incorrect IBAN format) and was not sent to the financial institution for verification.

Result Structure

Each item in a bulk request follows the exact same result model as a single verification request. This means that:
  • status
  • match_result
  • matched_name
  • status_reason
behave identically to the unitary verification endpoint. For a detailed explanation of match outcomes and their meaning, refer to: 👉 Match Results Documentation

Pagination

Results are returned using page-based pagination. Parameters:
  • page (optional) – Page number (default: 1)
The response includes:
  • current_page
  • per_page
  • total_pages
  • total_items
  • has_next_page
Continue fetching pages until has_next_page is false.

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Query Parameters

page
integer
default:1

Response

200 - application/json

Paginated bulk items

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>
pagination
object
items
object[]