Skip to main content
GET
/
accounts
/
{accountId}
/
bank-accounts
List Bank Accounts
curl --request GET \
  --url https://api.rolla.xyz/api/v1/external/accounts/{accountId}/bank-accounts \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "message": "Bank accounts retrieved successfully",
  "data": {
    "bankAccounts": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "bankName": "Guaranty Trust Bank",
        "accountNumber": "1238726395",
        "accountName": "Beta Logistics LLC",
        "routingNumber": "<string>",
        "swiftCode": "<string>",
        "bankAddress": "<string>",
        "status": "active",
        "expiresAt": "2023-11-07T05:31:56Z",
        "createdAt": "2023-11-07T05:31:56Z"
      }
    ],
    "usdOnboarding": [
      {
        "provider": "<string>",
        "state": "<string>",
        "updatedAt": "2023-11-07T05:31:56Z"
      }
    ]
  }
}
Lists the bank accounts issued for an account, along with any USD provider onboarding that is still under review.

​
Example Request

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

{
  "success": true,
  "message": "Bank accounts retrieved successfully",
  "data": {
    "bankAccounts": [
      {
        "id": "7f3a2b10-91c4-4f3b-b1d2-0a8e44c10a55",
        "currency": "NGN",
        "provider": "gtbank",
        "bankName": "Guaranty Trust Bank",
        "accountNumber": "1238726395",
        "accountName": "Beta Logistics LLC",
        "type": "static",
        "status": "active",
        "createdAt": "2026-06-13T01:50:00.000Z"
      }
    ],
    "usdOnboarding": [
      {
        "provider": "ssb_usd",
        "state": "client_submitted",
        "updatedAt": "2026-06-13T01:49:39.528Z"
      }
    ]
  }
}

​
Query Parameters

ParameterTypeRequiredDescription
currencystringNoFilter by NGN or USD

Authorizations

​
X-API-Key
string
header
required

Your Rolla API key

Path Parameters

​
accountId
string<uuid>
required

Identifier of an account owned by the same user as your API key's business

Query Parameters

​
currency
enum<string>
Available options:
NGN,
USD

Response

Bank accounts retrieved

​
success
boolean
Example:

true

​
message
string
Example:

"Bank accounts retrieved successfully"

​
data
object