- Introduction
- Terminologies
- Webhooks
- Authentication
- Account
- Transaction
- Transfer
- Invoice
- Refunds
- Notifications
- Merchant
- Admin
List Accounts
GET
/accounts/{externalId}
Request Body#
| Field Name | Type | Required | Description |
|---|---|---|---|
| externalId | string | TRUE | The unique identifier used to retrieve the associated accounts. It is same as the Group Code. |
Query Parameters#
| Field Name | Type | Required | Description |
|---|---|---|---|
| page | integer | FALSE | The page number for paginated results. |
| items | integer | FALSE | The number of accounts to return per page. |
Response Body#
| Field Name | Type | Description |
|---|---|---|
| name | string | The name associated with the account. |
| mainLedger | boolean | Indicates whether the account is a main ledger account. |
| bvn | string | The Bank Verification Number linked to the account. |
| accountID | string | The unique identifier assigned to the account. |
Request
Path Params
Query Params
Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/accounts/LRBRWEAJXM?page=5&items=1000'Responses
🟢200List Accounts
application/json
Body
Example
[
{
"name": "KEDCO Prepaid - 30530363313",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032834"
},
{
"name": "KEDCO Prepaid - 30530166922",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032810"
},
{
"name": "KEDCO Prepaid - 322247036101",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032793"
},
{
"name": "KEDCO Prepaid - 322247182201",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032779"
},
{
"name": "KEDCO Prepaid - 322247014701",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032755"
},
{
"name": "KEDCO Prepaid - 322764040701",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032731"
},
{
"name": "KEDCO Prepaid - 322247027201",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032717"
},
{
"name": "KEDCO Prepaid - 322247757501",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032690"
},
{
"name": "KEDCO Prepaid - 322247490301",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032676"
},
{
"name": "KEDCO Prepaid - 322247797701",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032652"
},
{
"name": "KEDCO Prepaid - 0179000265019",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032638"
},
{
"name": "KEDCO Prepaid - 30530336590",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032614"
},
{
"name": "KEDCO Prepaid - 349922025701",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032597"
},
{
"name": "KEDCO Prepaid - 322803131301",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032573"
},
{
"name": "KEDCO Prepaid - 04216281081",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032559"
},
{
"name": "KEDCO Prepaid - 04216095556",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032535"
},
{
"name": "KEDCO Prepaid - 94100493363",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032511"
},
{
"name": "KEDCO Prepaid - 57150056604",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032494"
},
{
"name": "KEDCO Prepaid - 0137200175743",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032470"
},
{
"name": "KEDCO Prepaid - 0150000839111",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032456"
},
{
"name": "KEDCO Prepaid - 30530109054",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032432"
},
{
"name": "KEDCO Prepaid - 30530067229",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032418"
},
{
"name": "KEDCO Prepaid - 58000082089",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032391"
},
{
"name": "KEDCO Prepaid - 30530305728",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032377"
},
{
"name": "KEDCO Prepaid - 62320127780",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032353"
},
{
"name": "KEDCO Prepaid - 30530338190",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032339"
},
{
"name": "KEDCO Prepaid - 30510067892",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032315"
},
{
"name": "KEDCO Prepaid - 04176590786",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032298"
},
{
"name": "KEDCO Prepaid - 62130281512",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032274"
},
{
"name": "KEDCO Postpaid - 344476505001",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032250"
},
{
"name": "KEDCO Prepaid - 349910019801",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032236"
},
{
"name": "KEDCO Prepaid - 349910018901",
"mainLedger": false,
"bvn": "22174212216",
"accountID": "9900032212"
},
{
"name": "KEDCO Prepaid - 349910017001",
"mainLedger": false,Modified at 2025-04-02 10:48:11