> ## Documentation Index
> Fetch the complete documentation index at: https://pay-docs.holdstation.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Verify Bank Account

> Verify a bank account number and retrieve account holder information.

## Overview

Partners can verify bank account numbers to confirm the account holder's name before initiating withdrawals.

<ParamField body="bin_code" type="string" required>
  Bank Identification Number (BIN) code.
</ParamField>

<ParamField body="account_number" type="string" required>
  Bank account number to verify.
</ParamField>

<RequestExample>
  ```json theme={null}
  {
    "bin_code": "970436",
    "account_number": "1234567890"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "message": "success",
    "data": {
      "bank": {
        "id": 1,
        "bank_name": "Vietcombank",
        "short_name": "VCB",
        "bin_code": "970436",
        "image": "https://example.com/vcb.png",
        "created_at": { "seconds": 1700000000, "nanos": 0 },
        "updated_at": { "seconds": 1700000000, "nanos": 0 }
      },
      "account_name": "NGUYEN VAN A",
      "account_number": "1234567890"
    }
  }
  ```

  ```json 400 theme={null}
  {
    "error": "invalid account",
    "error_code": "BAD_REQUEST",
    "message": "Account not found"
  }
  ```
</ResponseExample>