Skip to main content
GET
/
sandbox
/
account-holder-verifications
/
{id}
Get Verification
curl --request GET \
  --url https://api.ibantrack.com/api-v1/sandbox/account-holder-verifications/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "abc123ab-3171-4e97-92ec-a11e9fabc123",
  "status": "completed",
  "match_result": "match"
}
Sandbox Behavior: This endpoint returns the actual result of a previous Sandbox POST request if the ID matches.
For any valid UUID provided, the verification outcome is determined by the last digit of the id you provide. This allows you to test different integration flows easily.
Last Digitstatusmatch_resultUse Case
1completedmatchSuccessful verification
2completedno_matchName discrepancy
3completedclose_matchMinor typo / Partial match
4failednullTechnical/Bank error
For example, to simulate a Close Match, use an ID ending in 3:

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