Account Status

Verify bank accounts instantly with our Verify API. Verify determines within 15 seconds whether an account is open and valid. The API initiatives verification utilizing RTP or FedNow penny deposits (Orum’s penny) and pulls back the information from the real-time ping. In addition, Verify confirms ownership, and we push that information back to you via webhook.

Verification Status

Status of account verification.

Verification StatusDescription
pendingAcknowledgment of the request being received
validA bank account is open and valid
closedA bank account is closed
invalidThe bank account information provided is invalid
failedThe verification request has failed

Status Reasons

Possible status reason codes for failed, invalid, and closed accounts.

Status ReasonDescription
blocked_accountAn account in the transfer request was blocked or prohibits posting of transfers against it
closed_accountAccount number specified has been closed on the bank of account's books
deceased_partyOne of the parties in the transfer request was deceased
duplicated_transferDuplicate of a previous transfer request
invalid_accountThe account number provided is invalid or does not exist
invalid_fieldThere was erroneous, invalid, or missing data in the transfer request
invalid_routingThe routing number provided is invalid or does not exist
regulatory_errorThe transfer could not be completed because of limitations imposed by a regulator
unavailable_financial_institutionSending or receiving financial institution is currently not available or does not support this request type
unexpected_errorThere was an unexpected error with this transfer request
unsupported_transferTransfer type is not supported or forbidden

Verify Webhooks

Verify webhooks are configured using the same Deliver endpoints. For event_types the webhook configuration can either use subscribe_all or specifically use verify_account_updated for verify webhook events.

Sample Webhook Event

{
   "event_id": "36fa9e91-b63d-4cc4-9055-eab98198a7ea",
   "event_type": "verify_account_updated",
   "created_at": "2023-06-01T15:00:09.374Z",
   "event_data": {
       "account": {
           "id": "2b610cd7-0366-47a0-94c7-923dc0472bc5",
           "account_number": "12345678910",
           "routing_number": "102001017",
           "account_holder_name": "John Doe",
           "verification_status": "pending",
           "estimated_verification_date": "2023-07-26T00:00:00Z",
           "created_at": "2023-06-01T14:59:46.751044Z",
           "updated_at": "2023-06-01T15:00:05.250318Z"
       }
   }
}