---
title: "Get all bank branches"
method: GET
path: "/bank-branches"
---

# Get all bank branches

`GET /bank-branches`

## Request

- Base URL: `https://api.open-finance.ai/v2`
- URL: `https://api.open-finance.ai/v2/bank-branches`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.open-finance.ai/oauth/token` scopes: `read:providers`

## Query parameters

- `bankCode` string, required

## Response `200`

Response

- BankBranch[]
  - `branchCode` integer: The code of the branch
  - `city` string: The city where the branch is located
  - `POB` string, nullable: Post Office Box number
  - `branchName` string: The name of the branch
  - `fax` string, nullable: The fax number of the branch
  - `handicapAccess` string: Indicates if the branch has handicap access
  - `dayClosed` string: The day the branch is closed
  - `branchType` string: The type of the branch
  - `mergeBranch` string, nullable: Code of the branch it merged with, if applicable
  - `freeTel` string, nullable: Free telephone number
  - `closeDate` string, date-time, nullable: The date the branch was closed
  - `branchAddress` string: The address of the branch
  - `openDate` string, date-time: The date the branch was opened
  - `YCoordinate` number, double: The Y coordinate of the branch location
  - `XCoordinate` number, double: The X coordinate of the branch location
  - `telephone` string: The telephone number of the branch
  - `zipCode` string, nullable: The zip code of the branch
  - `bankCode` integer: The code of the bank
  - `mergeBank` string, nullable: Code of the bank it merged with, if applicable

## Other responses

- `401`: Unauthorized access - Invalid access token
- `403`: Forbidden - Access token missing the required permissions to perform this action
- `500`: Internal server error

---

[API](https://skmtc.dev/open-finance/apis/data.md) - [All operations](https://skmtc.dev/open-finance/apis/data/llms.txt) - [OpenAPI document](https://skmtc.dev/open-finance/apis/data/revisions/c18eafb2a770?raw)
