---
title: "Get Bank Verification Status"
method: GET
path: "/billing/bank-accounts/{bank_account_id}/verify"
tags: ["Billing", "billing"]
---

# Get Bank Verification Status

`GET /billing/bank-accounts/{bank_account_id}/verify`

## Request

- Base URL: `https://api.openintake.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openintake.ai/billing/bank-accounts/{bank_account_id}/verify`
- Auth: none declared

Get the current verification status of a bank account.

Admin only endpoint.

## Path parameters

- `bank_account_id` string, uuid, required

## Response `200`

Successful Response

- BankAccountVerification
  - `verificationMethod` 'instant' | 'ach', required
  - `status` 'new' | 'sent-credit' | 'max-attempts-exceeded' | 'failed' | 'expired' | 'successful', required
  - `exceptionDetails` BankAccountException: Reason for, and details related to, an `errored` or `verificationFailed` bank account status.
    - `description` string, required
    - `achReturnCode` 'R02' | 'R03' | 'R04' | 'R05' | 'R07' | 'R08' | 'R10' | 'R11' | 'R12' | 'R13' | 'R14' | 'R15' | 'R16' | 'R17' | 'R20' | 'R23' | 'R29' | 'R34' | 'R38' | 'R39': The return code of an ACH transaction that caused the bank account status to change. - R02: Account Closed - R03: No Account/Unable to Locate Account - R04: Invalid Account Number - R05: Improper Debit to Consumer Account - R07: Authorization Revoked by Customer - R08: Payment Stopped - R10: Customer Advises Originator is Not Known or Authorized to Receiver - R11: Customer Advises Entry Not in Accordance with the Terms of the Authorization - R12: Branch Sold to Another DFI - R13: RDFI not qualified to participate - R14: Representative payee deceased or unable to continue in that capacity - R15: Beneficiary or bank account holder - R16: Bank account frozen - R17: Entry with Invalid Account Number Initiated Under Questionable Circumstances - R20: Non-payment bank account - R23: Credit entry refused by receiver - R29: Corporate customer advises not authorized - R34: Limited participation RDFI - R38: Stop Payment on Source Document (Adjustment Entry) - R39: Improper Source Document
    - `rtpRejectionCode` 'AC03' | 'AC04' | 'AC06' | 'AC14' | 'AG01' | 'AG03' | 'MD07': The rejection code of an RTP transaction that caused the bank account status to change. - AC03: Account Invalid - AC04: Account Closed - AC06: Account Blocked - AC14: Creditor Account Type Invalid - AG01: Transactions Forbidden On Account - AG03: Transaction Type Not Supported - MD07: Customer Deceased
    - `fednowRejectionCode` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/openintake/apis/fastapi.md) · [All operations](https://skmtc.dev/openintake/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/openintake/apis/fastapi/revisions/0bfac9979fae?raw)