---
updatedAt: 2026-04-20T20:39:51.000Z
agentTools:
  siteIndex: https://docs.alpaca.markets/llms.txt
  projectIndex: https://docs.alpaca.markets/us/llms.txt
---

# Retrieve Bank Relationships for an Account

Retrieves Bank Relationships for an account

# OpenAPI definition

```json
{
  "components": {
    "parameters": {
      "AccountID": {
        "description": "Account identifier.",
        "in": "path",
        "name": "account_id",
        "required": true,
        "schema": {
          "format": "uuid",
          "type": "string"
        }
      }
    },
    "schemas": {
      "Bank": {
        "examples": [
          {
            "account_id": "56712986-9ff7-4d8f-8e52-077e099e533e",
            "account_number": "123456789abc",
            "bank_code": "123456789",
            "bank_code_type": "ABA",
            "city": "",
            "country": "",
            "created_at": "2022-02-11T21:35:19.268681613Z",
            "id": "8475c676-68e3-4cfc-a683-9ca2f47a6172",
            "name": "Bank XYZ",
            "postal_code": "",
            "state_province": "",
            "status": "QUEUED",
            "street_address": "",
            "updated_at": "2022-02-11T21:35:19.268681613Z"
          }
        ],
        "properties": {
          "account_id": {
            "format": "uuid",
            "type": "string"
          },
          "account_number": {
            "type": "string"
          },
          "bank_code": {
            "description": "9-Digit ABA RTN (Routing Number) or BIC",
            "type": "string"
          },
          "bank_code_type": {
            "description": "ABA (Domestic) or BIC (International)",
            "enum": [
              "ABA",
              "BIC"
            ],
            "type": "string"
          },
          "city": {
            "description": "Only for international banks",
            "type": "string"
          },
          "country": {
            "description": "Only for international banks",
            "type": "string"
          },
          "created_at": {
            "description": "Format: 2020-01-01T01:01:01Z",
            "example": "2021-03-16T18:38:01.942282Z",
            "format": "date-time",
            "type": "string"
          },
          "extra_fields": {
            "$ref": "#/components/schemas/BankAdditionalFields"
          },
          "id": {
            "example": "61e69015-8549-4bfd-b9c3-01e75843f47d",
            "format": "uuid",
            "type": "string"
          },
          "name": {
            "description": "Name of recipient bank",
            "type": "string"
          },
          "postal_code": {
            "description": "Only for international banks",
            "type": "string"
          },
          "state_province": {
            "description": "Only for international banks",
            "type": "string"
          },
          "status": {
            "description": "QUEUED, SENT_TO_CLEARING, APPROVED, REJECTED, CANCELED",
            "enum": [
              "QUEUED",
              "SENT_TO_CLEARING",
              "APPROVED",
              "REJECTED",
              "CANCELED"
            ],
            "type": "string"
          },
          "street_address": {
            "description": "Only for international banks",
            "type": "string"
          },
          "updated_at": {
            "description": "Format: 2020-01-01T01:01:01Z",
            "example": "2021-03-16T18:38:01.942282Z",
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "created_at",
          "updated_at",
          "name",
          "bank_code",
          "bank_code_type",
          "account_number"
        ],
        "type": "object"
      },
      "BankAdditionalFields": {
        "description": "Additional wire instructions used to explicitly specify intermediary (correspondent) banks for international wire transfers. If omitted, intermediary banks may be automatically selected by downstream institutions, which can result in delays or additional charges.\n",
        "properties": {
          "intermediary_bank1_bic": {
            "description": "The primary intermediary (correspondent) bank to be used when routing the international wire transfer to the beneficiary bank.",
            "type": "string"
          },
          "intermediary_bank2_bic": {
            "description": "An additional intermediary bank to be used if the wire transfer requires multiple correspondent banks before reaching the beneficiary bank.",
            "type": "string"
          },
          "intermediary_bank3_bic": {
            "description": "A tertiary intermediary bank used in complex international wire routes that require three correspondent banks prior to reaching the beneficiary bank.",
            "type": "string"
          }
        },
        "type": "object"
      }
    },
    "securitySchemes": {
      "BasicAuth": {
        "scheme": "basic",
        "type": "http"
      }
    }
  },
  "info": {
    "contact": {
      "email": "support@alpaca.markets",
      "name": "Alpaca Support",
      "url": "https://alpaca.markets/support"
    },
    "description": "Open brokerage accounts, enable stock, options and crypto trading. Manage the ongoing user experience and brokerage customer lifecycle with the Alpaca Broker API",
    "termsOfService": "https://s3.amazonaws.com/files.alpaca.markets/disclosures/library/TermsAndConditions.pdf",
    "title": "Broker API",
    "version": "1.1.1"
  },
  "openapi": "3.1.2",
  "paths": {
    "/v1/accounts/{account_id}/recipient_banks": {
      "get": {
        "description": "Retrieves Bank Relationships for an account",
        "operationId": "getRecipientBanks",
        "parameters": [
          {
            "in": "query",
            "name": "status",
            "schema": {
              "enum": [
                "ACTIVE",
                "INACTIVE"
              ],
              "example": "ACTIVE",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "bank_name",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/Bank"
                  },
                  "type": "array"
                }
              }
            },
            "description": "An array of Bank relationships attached to this Account.\n\nAn empty array will be returned if no Bank relationships have been attached to this account"
          },
          "400": {
            "description": "Bad request. The body in the request is not valid."
          }
        },
        "summary": "Retrieve Bank Relationships for an Account",
        "tags": [
          "Funding",
          "Accounts"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/AccountID"
        }
      ]
    }
  },
  "security": [
    {
      "BasicAuth": []
    }
  ],
  "servers": [
    {
      "description": "Sandbox endpoint",
      "url": "https://broker-api.sandbox.alpaca.markets"
    },
    {
      "description": "Production endpoint",
      "url": "https://broker-api.alpaca.markets"
    }
  ],
  "tags": [
    {
      "name": "Accounts"
    },
    {
      "name": "Funding"
    }
  ],
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": false
  }
}
```