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

# Bank Account List

> List linked bank accounts.

## Overview

This page documents the `GET /withdraw/open/otc/api/bank/list` endpoint. The full schema, parameters, and examples are rendered from the linked OpenAPI definition above.

## Notes

* Authentication uses the standard GatePay signed headers.
* This page documents the standard merchant endpoint.
* For shared signing rules, see [/api-reference/version/100/en/common/securityAndSignature](/api-reference/version/100/en/common/securityAndSignature).

## Supplemental Field Notes

### Request Filters

* `bankAccountName`: bank account name, supports fuzzy matching
* `iban`: account number or IBAN, supports fuzzy matching
* `swift`: SWIFT code, supports fuzzy matching
* `bankName`: bank name, supports fuzzy matching

### Key Response Fields

* `data[].countryId`: country ID
* `data[].countryName`: country name
* `data[].address`: bank address
* `data[].remittanceLineNumber`: routing or clearing code
* `data[].agentBankName`: agent bank name
* `data[].agentBankSwift`: agent bank SWIFT
* `data[].status`: bank account review status. `1` = approved, `2` = pending review, `3` = pending supplementary materials, `99` = rejected
* `data[].memo`: memo entered by operations staff, typically returned as the rejection reason when the bank account review is rejected


## OpenAPI

````yaml /api-reference/version/100/en/openapi/otc-fiat-openapi.json GET /withdraw/open/otc/api/bank/list
openapi: 3.1.0
info:
  title: GatePay OTC Fiat API
  description: Reference for OTC fiat withdrawal and deposit APIs.
  version: 2.1.0
servers:
  - url: https://openplatform.gateapi.io
security: []
paths:
  /withdraw/open/otc/api/bank/list:
    get:
      summary: Query Bank Account List
      description: List linked bank accounts.
      parameters:
        - $ref: '#/components/parameters/X-GatePay-Certificate-ClientId'
        - $ref: '#/components/parameters/X-GatePay-Signature'
        - $ref: '#/components/parameters/X-GatePay-Timestamp'
        - $ref: '#/components/parameters/X-GatePay-Nonce'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankListResponse'
components:
  parameters:
    X-GatePay-Certificate-ClientId:
      name: X-GatePay-Certificate-ClientId
      in: header
      required: true
      schema:
        type: string
      description: Merchant application client ID used to identify the calling app.
    X-GatePay-Signature:
      name: X-GatePay-Signature
      in: header
      required: true
      schema:
        type: string
      description: >-
        HMAC signature generated from the request according to GatePay signing
        rules.
    X-GatePay-Timestamp:
      name: X-GatePay-Timestamp
      in: header
      required: true
      schema:
        type: string
      description: Unix timestamp used for replay protection and signature verification.
    X-GatePay-Nonce:
      name: X-GatePay-Nonce
      in: header
      required: true
      schema:
        type: string
      description: Random nonce used together with the timestamp to prevent replay attacks.
  schemas:
    BankListResponse:
      type: object
      properties:
        code:
          type: string
          description: Business response code.
        status:
          type: string
          description: Top-level request status.
        data:
          type: array
          items:
            type: object
            properties:
              bankAccountId:
                type: string
                description: Bank account ID.
              bankAccountName:
                type: string
                description: Bank account holder name.
              bankName:
                type: string
                description: Bank name.
              countryId:
                type: integer
                description: Country ID.
              countryName:
                type: string
                description: Country name.
              address:
                type: string
                description: Bank address.
              iban:
                type: string
                description: IBAN or bank account number.
              swift:
                type: string
                description: SWIFT or BIC code.
              remittanceLineNumber:
                type: string
                description: Routing or clearing code.
              agentBankName:
                type: string
                description: Agent bank name.
              agentBankSwift:
                type: string
                description: Agent bank SWIFT.
              status:
                type: integer
                description: >-
                  Bank account review status. `1` = approved, `2` = pending
                  review, `3` = pending supplementary materials, `99` =
                  rejected.
                enum:
                  - 1
                  - 2
                  - 3
                  - 99
              memo:
                type: string
                description: >-
                  Memo entered by operations staff, typically returned as the
                  rejection reason when the bank account review is rejected.
          description: Linked bank account list.

````