Skip to main content
GET
List dedicated bank accounts
Use this endpoint to retrieve active dedicated accounts for the authenticated merchant and API key environment.

Endpoint

Headers

Example request

Successful response

Notes

  • Disabled dedicated accounts are not returned as usable accounts.
  • totalReceived is returned in kobo.
  • Use externalReference to map each account to your internal customer, invoice, subscription, or record.

Next step

Retrieve dedicated account

Fetch one dedicated account by reference or account number.

Webhooks

Handle payment notifications for dedicated account credits.

Authorizations

Authorization
string
header
required

Use an sk_test_... key in the playground. Never enter a live key in shared environments.

Response

Dedicated accounts retrieved.

status
boolean
required
message
string
required
data
object
required