Skip to main content
GET
/
account-holder-verifications
/
{id}
Get Verification
curl --request GET \
  --url https://api.ibantrack.com/api-v1/account-holder-verifications/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "abc123ab-3171-4e97-92ec-a11e9fabc123",
  "status": "completed",
  "match_result": "match"
}
This endpoint is optional for standard workflows as the POST request is synchronous.
It is provided primarily for your internal audit logs and data recovery.

​
When to use this

Use this endpoint if you need to retrieve a previously created verification.

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

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