Skip to main content
POST
/
account-holder-verifications
/
bulk
Submit Bulk IBAN Holder Verifications
curl --request POST \
  --url https://api.ibantrack.com/api-v1/account-holder-verifications/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "verifications": [
    {
      "account": {
        "iban": "FR7630004000031234567890143"
      },
      "account_holder": {
        "name": "Jean Dupont"
      }
    },
    {
      "account": {
        "iban": "FR1420041010050500013M02606"
      },
      "account_holder": {
        "name": "Marie Martin"
      }
    },
    {
      "account": {
        "iban": "FR7630006000011234567890189"
      },
      "account_holder": {
        "name": "SARL TECHSOLUTIONS"
      }
    }
  ]
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "accepted",
  "total_items": 123,
  "created_at": "2023-11-07T05:31:56Z"
}

​
Overview

This endpoint allows you to submit up to 2000 IBAN account holder verifications in a single request. The bulk request is processed asynchronously.
Once accepted, you can monitor its progress using the bulk status endpoint.

​
Processing model

  • Credits are debited at submission time.
  • Each item is processed independently.
  • Items with invalid format are marked as rejected and are not billed.
  • If an item format was valid but the financial institution could not process the verification, the item is marked as failed. It this case, details are provided in the status_reason field.

​
Limits

  • Maximum 2000 items per request.
  • Minimum 1 item.

​
Response

A 200 Accepted response indicates that the bulk has been successfully created and scheduled for processing. Use the returned id to retrieve the bulk status and results.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
verifications
object[]
required

List of account holder verifications to process in bulk (maximum 2000 per request).

Required array length: 1 - 2000 elements

Response

Bulk accepted for processing

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