List accounts

get

Authorizations

Bearer

AuthorizationstringRequired

API Key as Bearer Token

Query parameters

searchstringOptional

pageinteger · int32Optional

page_sizeinteger · int32Optional

CurrencystringOptional

Responses

200

Success

application/json

statusstring · enumOptionalPossible values:

messagestring · nullableOptional

is_errorbooleanRead-onlyOptional

get

/v1/customer-dedicated-accounts

HTTPcURLJavaScriptPython

GET /v1/customer-dedicated-accounts HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

200

Success

{
  "status": "success",
  "message": "text",
  "data": [
    {
      "id": "text",
      "is_live": true,
      "account_reference": "text",
      "gateway_code": "text",
      "callback_url": "text",
      "account_name": "text",
      "account_number": "text",
      "country": "text",
      "bank_code": "text",
      "bank_name": "text",
      "currency": "text",
      "bvn": "text",
      "metadata": "text",
      "created_at": "2026-03-28T18:08:51.834Z",
      "edited_at": "2026-03-28T18:08:51.834Z",
      "customer_id": "text",
      "payout_tag": "text",
      "payout_tag_description": "text",
      "payout_tag_metadata": "text"
    }
  ],
  "meta": {
    "page_meta": {
      "page_count": 1,
      "item_count": 1,
      "search": "text",
      "page": 1,
      "page_size": 1
    }
  },
  "errors": {
    "ANY_ADDITIONAL_PROPERTY": [
      "text"
    ]
  },
  "is_error": true
}