---
title: "List external bank accounts"
method: GET
path: "/bank-accounts"
tags: ["External Bank Account"]
---

# List external bank accounts

`GET /bank-accounts`

## Request

- Base URL: `https://api.enterprise.airtm.com/v2`
- URL: `https://api.enterprise.airtm.com/v2/bank-accounts`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/airtm/apis/airtm-enterprise-api-v2/docs/bank-accounts/get.ts> (a function with typed inputs; its response is checked against the schema)

List paginated external bank accounts

## Query parameters

- `before` string
- `after` string
- `perPage` integer
- `accountType` 'us_ach' | 'us_wire' | 'iban'

## Response `200`

Ok

- PaginatedBankExternalAccountResponse: Represents a paginated collection of items.
  - `items` BankExternalAccountResponse[], required: The items in the current page.
    - `id` string, required: The id of the bank external account.
    - `accountType` 'us_ach' | 'us_wire' | 'iban', required
    - `currency` 'USD' | 'EUR', required
    - `bankName` string, required: The name of the bank.
    - `accountOwnerName` string, required: The name of the account owner.
    - `businessName` string, required: The name of the business.
    - `address` object: The address of the business.
      - `country` string, required
      - `postalCode` string
      - `state` string, required
      - `city` string, required
      - `streetLine2` string
      - `streetLine1` string, required
    - `usAccount` object: The account details for US ACH or US Wire accounts.
      - `checkingOrSavings` string
      - `routingNumber` string, required
      - `accountNumber` string, required
    - `iban` object: The IBAN details for IBAN accounts.
      - `country` string, required
      - `bic` string, required
      - `accountNumber` string, required
    - `swift` object: Optional: The SWIFT details for IBAN account. When accountType is 'iban', the swift field is optional, meaning you can include it to provide additional SWIFT-specific information (like business context, purpose of funds, etc.), but it's not required for basic IBAN account creation.
      - `shortBusinessDescription` string, required
      - `purposeOfFunds` string[], required
      - `category` string, required
      - `address` object, required
        - `country` string, required
        - `postalCode` string
        - `state` string, required
        - `city` string, required
        - `streetLine2` string
        - `streetLine1` string, required
      - `account` object, required
        - `country` string, required
        - `bic` string, required
        - `accountNumber` string, required
    - `createdAt` string, required: The date and time the bank external account was created.
    - `updatedAt` string, required: The date and time the bank external account was updated.
  - `startCursor` string: The cursor for the first item in the current page.
  - `endCursor` string: The cursor for the last item in the current page.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/airtm/apis/airtm-enterprise-api-v2.md) - [All operations](https://skmtc.dev/airtm/apis/airtm-enterprise-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/airtm/apis/airtm-enterprise-api-v2/revisions/c9ed13d4c5c0?raw)
