---
title: "Query bank verification result"
method: GET
path: "/merchants/{merchantId}/banv/{bankVerificationId}/status"
tags: ["Bank Account Verification"]
---

# Query bank verification result

`GET /merchants/{merchantId}/banv/{bankVerificationId}/status`

Retrieve the result of a previously created bank verification request.

For more information, see the [documentation](https://developer.peachpayments.com/docs/payouts-api-1#query-bank-verification-result-flow), and for sample calls, see the [public Postman collection](https://www.postman.com/peachpayments/peach-payments-public-workspace/request/13324425-94b991cd-1245-4cd6-a33b-5b5740c635f1).

## Path parameters

- `merchantId` string, required — A unique merchant ID provided by Peach Payments in hexadecimal format.
- `bankVerificationId` string, required — A valid v4 UUID expressed in lowercase with dashes.

## Response `200`

Bank verification result

- BankVerificationResponse — The status and field match results for a bank account verification request.
  - `bankVerificationId` string, required — A valid v4 UUID expressed in lowercase with dashes.
  - `created` string, date-time, required
  - `lastUpdated` string, date-time, required
  - `accountNumber` 'positive' | 'negative' | 'unverified', required — The per-field comparison result for a bank verification.
  - `idNumber` 'positive' | 'negative' | 'unverified', required — The per-field comparison result for a bank verification.
  - `initials` 'positive' | 'negative' | 'unverified', required — The per-field comparison result for a bank verification.
  - `lastName` 'positive' | 'negative' | 'unverified', required — The per-field comparison result for a bank verification.
  - `accountOpen` 'positive' | 'negative' | 'unverified', required — The per-field comparison result for a bank verification.
  - `accountAcceptsCredits` 'positive' | 'negative' | 'unverified', required — The per-field comparison result for a bank verification.
  - `accountAcceptsDebits` 'positive' | 'negative' | 'unverified', required — The per-field comparison result for a bank verification.
  - `accountOpenGtThreeMonths` 'positive' | 'negative' | 'unverified', required — The per-field comparison result for a bank verification.
  - `accountType` 'positive' | 'negative' | 'unverified', required — The per-field comparison result for a bank verification.
  - `status` 'pending' | 'processing' | 'successful' | 'failed', required — The current status of the bank account verification request.
  - `resultCode` string, string, required — The result code indicating the status or error of the payout.

## Other responses

- `400` — There was an error with the request. Please fix the request and try again.
- `401` — The request is not authenticated. Please re-authenticate and provide a new token.
- `403` — The request is not authorised. Please contact your business administrator.
- `404` — Not found.

---

[API](https://skmtc.net/peachpayments/apis/checkout.md) · [All operations](https://skmtc.net/peachpayments/apis/checkout/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/peachpayments/checkout/revisions/3a98165665f8/schema)