---
title: "Query Customer Bank Accounts"
method: GET
path: "/v2/customers/{customerId}/bankaccounts"
tags: ["customer"]
---

# Query Customer Bank Accounts

`GET /v2/customers/{customerId}/bankaccounts`

## Request

- Base URL: `https://scx-sbx.api.jtl-software.com`
- URL: `https://scx-sbx.api.jtl-software.com/v2/customers/{customerId}/bankaccounts`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://auth.jtl-cloud.com/oauth2/auth`
    - Token URL: `https://auth.jtl-cloud.com/oauth2/token` scopes: `customers.read`
  - OAuth 2
    - Client credentials
    - Token URL: `https://auth.jtl-cloud.com/oauth2/token` scopes: `customers.read`
- TypeScript: <https://skmtc.dev/jtl-software/apis/scx-authentication-api/docs/v2/customers/:customerId/bankaccounts/get.ts> (a function with typed inputs; its response is checked against the schema)

Query all bank accounts for a specific customer

## Path parameters

- `customerId` string, uuid, required: Represents a unique key for identifying a customer in the JTL system.

## Headers

- `x-tenant-id` string, uuid, required
- `x-runas` string
- `x-companyid` string

## Response `200`

The requested bank account of the customer.

- JTLWawiRestContractsModelsV1CustomerCustomerBankAccount[]
  - `id` string, uuid
  - `accountHolder` string: Name of the account holder of the customer's bank account.
  - `bankName` string: Name of the bank.
  - `accountNumber` string: Account number of the customer's bank account.
  - `bankCode` string: Bank code of the customer bank's account.
  - `iBAN` string: International bank account number of the customer's bank account.
  - `bIC` string: Bank identification code of the customer's bank account.

## Other responses

- `401`
- `402`: No licence available or the app has not been authorised by JTL.
- `404`: No data could be found.

---

[API](https://skmtc.dev/jtl-software/apis/scx-authentication-api.md) - [All operations](https://skmtc.dev/jtl-software/apis/scx-authentication-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jtl-software/apis/scx-authentication-api/revisions/f979b1ea6951?raw)