> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rolla.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# List Bank Accounts

> Lists the account's issued bank accounts, plus any USD provider onboarding still in review.

Lists the bank accounts issued for an account, along with any USD provider onboarding that is still under review.

A client may hold several USD accounts — one per [`reference`](/api-reference/endpoint/accounts/issue-bank-account#multiple-usd-deposit-accounts). Every entry carries `reference` and `label` so you can tell them apart; both are `null` on the client's primary account.

## Example Request

```bash theme={null}
curl -X GET "https://api.rolla.xyz/api/v1/external/accounts/eec3cbed-79d8-4370-87a0-b6be9e287337/bank-accounts" \
  -H "X-API-Key: your_api_key_here"
```

## Example Response

```json theme={null}
{
  "success": true,
  "message": "Bank accounts retrieved successfully",
  "data": {
    "bankAccounts": [
      {
        "id": "7f3a2b10-91c4-4f3b-b1d2-0a8e44c10a55",
        "currency": "NGN",
        "provider": "rolla",
        "bankName": "Guaranty Trust Bank",
        "accountNumber": "1238726395",
        "accountName": "Beta Logistics LLC",
        "type": "static",
        "status": "active",
        "reference": null,
        "label": null,
        "createdAt": "2026-06-13T01:50:00.000Z"
      },
      {
        "id": "b2c7d918-4e10-4b6a-8d55-1f0a9c3e77b2",
        "currency": "USD",
        "provider": "rolla",
        "bankName": "Lead Bank",
        "accountNumber": "8823410077",
        "accountName": "Beta Logistics LLC",
        "routingNumber": "021000021",
        "type": "static",
        "status": "active",
        "reference": "store-amazon-uk",
        "label": "Amazon UK",
        "createdAt": "2026-06-14T09:22:11.000Z"
      }
    ],
    "usdOnboarding": [
      {
        "provider": "rolla",
        "state": "client_submitted",
        "updatedAt": "2026-06-13T01:49:39.528Z"
      }
    ]
  }
}
```

## Query Parameters

| Parameter  | Type   | Required | Description              |
| ---------- | ------ | -------- | ------------------------ |
| `currency` | string | No       | Filter by `NGN` or `USD` |


## OpenAPI

````yaml GET /accounts/{accountId}/bank-accounts
openapi: 3.1.0
info:
  title: Rolla Developer API
  description: >-
    API for programmatic transaction management on the Rolla platform. Monetary
    `amount` fields use the smallest unit of the referenced currency unless an
    endpoint says otherwise (e.g. NGN = kobo, USD = cents, where **100 cents =
    USD 1.00**).
  version: 1.0.0
servers:
  - url: https://api.rolla.xyz/api/v1/external
    description: Production server
security:
  - apiKeyAuth: []
paths:
  /accounts/{accountId}/bank-accounts:
    get:
      summary: List Bank Accounts
      description: >-
        Lists the account's issued bank accounts, plus any USD provider
        onboarding still in review.
      operationId: listBankAccounts
      parameters:
        - name: accountId
          in: path
          required: true
          description: >-
            Identifier of an account owned by the same user as your API key's
            business
          schema:
            type: string
            format: uuid
        - name: currency
          in: query
          schema:
            type: string
            enum:
              - NGN
              - USD
      responses:
        '200':
          description: Bank accounts retrieved
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Bank accounts retrieved successfully
                  data:
                    type: object
                    properties:
                      bankAccounts:
                        type: array
                        items:
                          $ref: '#/components/schemas/BankAccount'
                      usdOnboarding:
                        type: array
                        items:
                          type: object
                          properties:
                            state:
                              type: string
                            updatedAt:
                              type: string
                              format: date-time
        '401':
          description: Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Account not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    BankAccount:
      type: object
      properties:
        id:
          type: string
          format: uuid
        currency:
          type: string
          enum:
            - NGN
            - USD
        bankName:
          type: string
          example: Guaranty Trust Bank
        accountNumber:
          type: string
          example: '1238726395'
        accountName:
          type: string
          example: Beta Logistics LLC
        routingNumber:
          type: string
          nullable: true
          description: USD accounts only
        swiftCode:
          type: string
          nullable: true
          description: USD accounts only
        bankAddress:
          type: string
          nullable: true
        type:
          type: string
          enum:
            - static
            - dynamic
        status:
          type: string
          example: active
        expiresAt:
          type: string
          format: date-time
          nullable: true
        createdAt:
          type: string
          format: date-time
        reference:
          type: string
          nullable: true
          description: >-
            The reference this account was issued under, or `null` on the
            client's primary account. Lets you tell a client's accounts apart
            without keeping your own mapping.
          example: store-amazon-uk
        label:
          type: string
          nullable: true
          description: The label this account was issued with, if any.
          example: Amazon UK
    Error:
      type: object
      properties:
        success:
          type: boolean
          example: false
        message:
          type: string
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Your Rolla API key

````