Skip to main content
POST
/
account-holder-verifications
Verify IBAN Holder
curl --request POST \
  --url https://api.ibantrack.com/api-v1/account-holder-verifications \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account": {
    "iban": "FR7630004000031234567890143"
  },
  "account_holder": {
    "name": "Jean Dupont"
  }
}
'
{
  "id": "abc123ab-3171-4e97-92ec-a11e9fabc123",
  "status": "completed",
  "match_result": "match"
}

​
Overview

This endpoint is the core of Ibantrack. It allows you to verify whether the provided name matches the holder of the specified IBAN, in real-time and across the SEPA zone. The verification is performed synchronously by querying the responding bank. Use the interactive API playground to test requests directly from this page: Authenticate using your API token, modify request parameters, and inspect real API responses

​
Request payload

​
Required fields

FieldTypeDescription
account.ibanstringIBAN to verify (SEPA countries supported)
account_holder.namestringIndividual full name or business legal name

​
Example requests

​
Individual — France

{
  "account": {
    "iban": "FR7630004000031234567890143"
  },
  "account_holder": {
    "name": "Jean Dupont"
  }
}

​
Business — Germany

{
  "account": {
    "iban": "DE80500105172521224695"
  },
  "account_holder": {
    "name": "Blue Horizon Travel Group"
  }
}
Timeout Notice: Responses typically take 1-3 seconds, but can take up to 20 seconds for some European banks. Set your client timeout accordingly.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
account
object
required
​
account_holder
object
required

Response

Verification completed

​
id
string<uuid>
Example:

"abc123ab-3171-4e97-92ec-a11e9fabc123"

​
status
enum<string>

The current lifecycle state of the verification request. A completed status indicates that the financial institution has been successfully reached and processed the request. A failedstatus indicates that the verification could not be completed due to technical or institutional constraints. Additional details may be provided in the status_reasonfield.

Available options:
pending,
completed,
failed
​
match_result
enum<string>

The outcome of the account holder name verification against the financial institution’s records. Provided only when statusis completed.

Available options:
match,
close_match,
no_match,
unable_to_verify
​
matched_name
string

Indicates the name as registered by the financial institution. Provided only if 'match_result' is 'close_match' and in accordance with data privacy regulations.

Example:

"JEAN DUPONT"

​
status_reason
string

Additional context on the request status. Primarily populated when status is 'failed' or when match_result is 'unable_to_match'

Example:

"responding_institution_timeout"

​
enrichment
object