---
updatedAt: 2025-09-09T20:37:57.000Z
agentTools:
  projectIndex: https://docs.qorcommerce.io/llms.txt
---

# Fetch Bank Account(s)

Fetch a Merchant's bank account(s) information

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "3.0",
    "title": "QorCommerce Endpoints",
    "description": "API Version 3"
  },
  "paths": {
    "/channels/bank_accounts": {
      "get": {
        "operationId": "channels-bank-accounts",
        "summary": "Fetch Bank Account(s)",
        "tags": [
          "Channels > Merchant Management"
        ],
        "description": "Fetch a Merchant's bank account(s) information",
        "parameters": [
          {
            "$ref": "#/components/parameters/trait_qorHeaderAuthentication_Qor-App-Key"
          },
          {
            "$ref": "#/components/parameters/trait_qorHeaderChannelsAuthentication_Qor-Client-Key"
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "description": "The status of the transaction.\n\nPossible response values are `ok` and `error`"
                    },
                    "code": {
                      "type": "string",
                      "description": "See [Payment Response Codes](doc:payment-response-codes) for more detail."
                    },
                    "message": {
                      "type": "string",
                      "description": "A payment gateway status code message."
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "description": "The total number of bank accounts present in this response."
                        },
                        "bank_accounts": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "created": {
                                "type": "string",
                                "description": "The date that this specific bank account was created."
                              },
                              "id": {
                                "type": "string",
                                "description": "The ID of this specific bank account."
                              },
                              "number": {
                                "type": "string",
                                "description": "The last four digits of the card number associated with this specific bank account."
                              },
                              "routing": {
                                "type": "string",
                                "description": "The last four digits of the routing number associated with this specific bank accounts"
                              },
                              "method": {
                                "type": "string",
                                "description": "The type of this specific bank account."
                              },
                              "is_primary": {
                                "type": "integer",
                                "description": "Indicator of whether or not this is the primary bank account.\n\nPossible response values are `0` and `1`"
                              },
                              "status": {
                                "type": "string",
                                "description": "The status of this specific bank account."
                              },
                              "is_inactive": {
                                "type": "integer",
                                "description": "Indicates whether or not this withdrawal schedule is inactive.\n\nPossible response values are `0` and `1`"
                              },
                              "is_frozen": {
                                "type": "integer",
                                "description": "Indicates whether or not this withdrawal schedule is frozen.\n\nPossible response values are `0` and `1`"
                              },
                              "type": {
                                "type": "string",
                                "description": "The type of account that this specific bank account is.\n\nPossible response values are `all`, `debit` and `credit`"
                              },
                              "reserved": {
                                "type": "string",
                                "description": "Indicates whether or not the bank account is reserved and what action will take place if so."
                              }
                            }
                          }
                        }
                      }
                    }
                  },
                  "required": [
                    "status",
                    "code",
                    "message"
                  ]
                },
                "examples": {
                  "response": {
                    "value": {
                      "status": "",
                      "code": "",
                      "message": "",
                      "data": {
                        "count": 0,
                        "bank_accounts": [
                          {
                            "created": "",
                            "id": "",
                            "number": "",
                            "routing": "",
                            "method": "",
                            "is_primary": 0,
                            "status": "",
                            "is_inactive": 0,
                            "is_frozen": 0,
                            "type": "",
                            "reserved": ""
                          }
                        ]
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api-sandbox.qorcommerce.io/v3"
    }
  ],
  "components": {
    "parameters": {
      "trait_qorHeaderAuthentication_Qor-App-Key": {
        "name": "Qor-App-Key",
        "in": "header",
        "description": "The unique key identifying the app making this request.\n\nNOTE: If testing use **`T6554252567241061980`** for the **`Qor-App-Key`** header key.",
        "required": true,
        "schema": {
          "type": "string",
          "maxLength": 24,
          "default": "T6554252567241061980"
        }
      },
      "trait_qorHeaderChannelsAuthentication_Qor-Client-Key": {
        "name": "Qor-Client-Key",
        "in": "header",
        "description": "The Client key represents an authorized **merchant account**  and is assigned by QorCommerce or your merchant service account provider.\n\n**NOTE:**  If testing use `01dffeb784c64d098c8c691ea589eb82 `  for the `Qor-Client-Key` header key.",
        "required": true,
        "schema": {
          "type": "string",
          "default": "01dffeb784c64d098c8c691ea589eb82"
        }
      }
    }
  },
  "x-explorer-enabled": true,
  "x-proxy-enabled": true,
  "x-samples-enabled": true,
  "x-samples-languages": [
    "curl",
    "csharp",
    "node",
    "ruby",
    "java",
    "javascript",
    "php",
    "python",
    "swift"
  ]
}
```