> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ibantrack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Bulk Verification Items

> Create the status of bulk verification 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](https://docs.ibantrack.com/documentation/core-concepts/match-results)

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


## OpenAPI

````yaml GET /account-holder-verifications/bulk/{id}/items
openapi: 3.0.0
info:
  title: Ibantrack API
  description: IBAN account holder verification API
  version: 1.0.0
servers:
  - url: https://api.ibantrack.com/api-v1
    description: Production
security: []
paths:
  /account-holder-verifications/bulk/{id}/items:
    get:
      tags:
        - Account Holder Verifications
      summary: Get Bulk Items
      operationId: getBulkItems
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
      responses:
        '200':
          description: Paginated bulk items
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkItemsResponse'
              example:
                id: c05acb57-40e7-4a2d-9368-d5ea8b27d413
                status: completed
                total_items: 250
                completed_items: 247
                failed_items: 1
                rejected_items: 2
                in_progress_items: 0
                created_at: '2026-02-16T18:14:15Z'
                pagination:
                  current_page: 2
                  per_page: 100
                  total_items: 250
                  total_pages: 3
                  has_next_page: true
                items:
                  - index: 100
                    id: e5974646-d346-4a4e-80f3-53d7449dea8a
                    status: completed
                    match_result: close_match
                    matched_name: MARGUERITE DUHAMEL
                  - index: 101
                    status: rejected
                    status_reason: invalid_iban_format
                  - index: 102
                    id: 04bb7ab7-e2e6-47a0-bd01-d9e1402c3feb
                    status: failed
                    status_reason: institution_out_of_scope
      security:
        - bearerAuth: []
components:
  schemas:
    BulkItemsResponse:
      allOf:
        - $ref: '#/components/schemas/BulkStatusResponse'
        - type: object
          properties:
            pagination:
              type: object
              properties:
                current_page:
                  type: integer
                per_page:
                  type: integer
                total_items:
                  type: integer
                total_pages:
                  type: integer
                has_next_page:
                  type: boolean
            items:
              type: array
              items:
                $ref: '#/components/schemas/BulkItemResponse'
    BulkStatusResponse:
      type: object
      properties:
        id:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - accepted
            - processing
            - completed
        total_items:
          type: integer
        completed_items:
          type: integer
        failed_items:
          type: integer
        in_progress_items:
          type: integer
        rejected_items:
          type: integer
        created_at:
          type: string
          format: date-time
    BulkItemResponse:
      type: object
      properties:
        index:
          type: integer
          description: Position of the item in the original bulk request.
        id:
          type: string
          format: uuid
          nullable: true
          description: Verification ID. Null if item was rejected.
        status:
          type: string
          enum:
            - pending
            - completed
            - failed
            - rejected
        match_result:
          type: string
          enum:
            - match
            - close_match
            - no_match
            - account_not_verifiable
          nullable: true
        matched_name:
          type: string
          nullable: true
        status_reason:
          type: string
          nullable: true
        enrichment: 2159ea13-1288-45b4-b5a3-77e60c324623
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````