Retrieve bank account lookup verification results
On this page, you will learn how to retrieve detailed information about a processed bank account lookup verification.
Get bank account lookup verification results via Webhooks
Webhooks provide an efficient way to get notified when a bank account lookup verification has been completed, and to retrieve the related verification results.
For more details on setting up and managing Webhooks, please refer to this dedicated section.
To receive those notifications, subscribe to the following event:
Event | Description |
---|---|
verification.bank_account_lookup.done | Triggered when a bank account lookup verification is complete |
Example Webhook Payload for a verified bank account lookup verification:
{
"event_id": "57ec86c3-23b4-4720-aaf6-535e46347a94",
"event_name": "verification.bank_account_lookup.done",
"event_time": "1348177752",
"subscription_id": "d09f0367-d80a-309c-a2ed-7083991fc564",
"subscription_description": "A great webhook",
"sandbox": false,
"data": {
"bank_account_lookup": {
"id": "dd507dfa-cac6-48be-ae5e-0754b552e96b",
"workspace_id": "090b4f7e-25e8-423d-9387-741f6188ba7a",
"created_at": "2025-03-24T13:32:26+00:00",
"updated_at": "2025-03-24T13:32:46+00:00",
"status": "verified",
"status_codes": []
}
}
}
For more information on the statuses and error codes, refer to this section.
Retrieve detailed bank account lookup verification results
You can also obtain detailed verification results by calling a dedicated endpoint, with the id
returned when requesting a bank account lookup verification:
GET /verifications/bank_account_lookups/{id}
{
"id": "dd507dfa-cac6-48be-ae5e-0754b552e96b",
"workspace_id": "090b4f7e-25e8-423d-9387-741f6188ba7a",
"created_at": "2025-03-24T13:32:26+00:00",
"updated_at": "2025-03-24T13:32:46+00:00",
"status": "verified",
"status_codes": []
}
Similar to the webhook, you will receive the verification status and any associated error codes if the verification was not verified
. For more information on the statuses and error codes, refer to this section.
List all bank account lookup verification requests
To retrieve a list of all verification requests, you can call the following endpoint. You can filter by status or paginate the results based on your needs:
GET /verifications/bank_account_lookups
{
"meta": {
"next_cursor": null
},
"data": [
{
"id": "8222ffef-99ef-4b1f-9a1d-013389866974",
"workspace_id": "090b4f7e-25e8-423d-9387-741f6188ba7a",
"created_at": "2025-01-28T15:32:55+00:00",
"updated_at": "2025-01-28T15:33:15+00:00",
"status": "failed",
"status_codes": [
"BALV_1501"
]
}
]
}
Updated 1 day ago