Skip to main content
GET
/
accounts
cURL
curl --request GET \
  --url https://api.spotflow.co/api/v1/accounts \
  --header 'Authorization: Bearer <token>'
[
  {
    "content": [
      {
        "id": "c1fba25a-a36b-479c-b17d-64dbaf3ba32c",
        "balanceId": "bln_52448a75-248e-4277-932f-5af5c325d372",
        "accountName": "Main GHS Account",
        "accountNumber": "7706438396",
        "parentAccountId": "c1fba25a-a36b-479c-b17d-64dbaf3ba32c",
        "currency": "GHS",
        "mode": "live",
        "accountTag": "main-account",
        "status": "active",
        "createdAt": "2025-07-22T11:25:28.792959Z",
        "updatedAt": "2025-08-07T11:56:49.337647Z",
        "accountDetails": {
          "accountName": "SPOTFLOW/Quantum Technologies",
          "accountNumber": "7806438396",
          "bankName": "Testbank MFB"
        }
      }
    ],
    "pageNumber": 123,
    "pageSize": 123,
    "totalElements": 123,
    "totalPages": 123
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
page
integer
default:0

Page number for pagination (default is 0).

​
size
integer
default:10

Number of items per page for pagination (default is 10).

​
accountTag
enum<string>

This can either be sub-account, or main-account.

Available options:
sub-account,
main-account
​
currency
enum<string>

Choose the currency you want for your sub account. According, to our currently supported currencies, this is in NGN or GHS.

Available options:
NGN,
GHS
​
mode
enum<string>

This can either be test or live mode.

Available options:
test,
live
​
accountNumber
string

This filters by the account number created for the sub accounts.

​
from
string<date-time>
​
to
string<date-time>

Response

A JSON array of subaccounts objects.

​
content
object[]
​
pageNumber
integer
​
pageSize
integer
​
totalElements
integer
​
totalPages
integer