---
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`

## Request

- Base URL: `https://sandbox-payouts.peachpayments.com/api`
- URL: `https://sandbox-payouts.peachpayments.com/api/merchants/{merchantId}/banv/{bankVerificationId}/status`
- Auth: HTTP bearer

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.dev/peachpayments/apis/payouts.md) - [All operations](https://skmtc.dev/peachpayments/apis/payouts/llms.txt) - [OpenAPI document](https://skmtc.dev/peachpayments/apis/payouts/revisions/a53677a021ef?raw)