Get Collection Accounts

This API retrieves a list of all collection accounts associated with a specified clientId. The accounts may include Normal, Utility, and Invoice collection types.

Path Parameter

Field Name	Type	Required	Description
clientId	string	true	The unique identifier of a client (merchant)

Response Body

Field Name	Type	Description
`normal`	object	Contains details of the normal collection account.
`normal.name`	string	The name of the normal collection account.
`normal.balance`	decimal	The total balance available in the normal collection account.
`normal.availableBalance`	decimal	The balance that is available for transactions.
`normal.blockedAmount`	decimal	The amount that is currently blocked and not available for transactions.
`normal.mainLedger`	boolean	Indicates whether the account is a main ledger account (`true` or `false`).
`normal.bvn`	string	The Bank Verification Number (BVN) associated with the account.
`normal.groupCode`	string	The unique identifier for the account's group.
`normal.accountID`	string	The unique account identifier.

Field Name	Type	Description
`utility`	object	Contains details of the utility collection account.
`utility.name`	string	The name of the utility collection account.
`utility.balance`	decimal	The total balance available in the utility collection account.
`utility.availableBalance`	decimal	The balance that is available for transactions.
`utility.blockedAmount`	decimal	The amount that is currently blocked and not available for transactions.
`utility.mainLedger`	boolean	Indicates whether the account is a main ledger account (`true` or `false`).
`utility.bvn`	string	The Bank Verification Number (BVN) associated with the account.
`utility.groupCode`	string	The unique identifier for the account's group.
`utility.accountID`	string	The unique account identifier.

Field Name	Type	Description
`invoice`	object	Contains details of the invoice collection account.
`invoice.name`	string	The name of the invoice collection account.
`invoice.balance`	decimal	The total balance available in the invoice collection account.
`invoice.availableBalance`	decimal	The balance that is available for transactions.
`invoice.blockedAmount`	decimal	The amount that is currently blocked and not available for transactions.
`invoice.mainLedger`	boolean	Indicates whether the account is a main ledger account (`true` or `false`).
`invoice.bvn`	string	The Bank Verification Number (BVN) associated with the account.
`invoice.groupCode`	string	The unique identifier for the account's group.
`invoice.accountID`	string	The unique account identifier.

Responses

🟢200Get Collection Accounts

application/json

Body

Example

{
    "normal": {
        "name": "Uber Banking Main Account",
        "balance": 0,
        "availableBalance": 0,
        "blockedAmount": 0,
        "mainLedger": false,
        "bvn": "8080909",
        "groupCode": "ER3GZR04KR",
        "accountID": "4000000257"
    },
    "utility": {
        "name": "Landmark POS Agents SubLedger",
        "balance": 0,
        "availableBalance": 0,
        "blockedAmount": 0,
        "mainLedger": false,
        "bvn": "12121211221",
        "groupCode": "0000000127",
        "accountID": "0000000345"
    },
    "invoice": {
        "name": "Main SubLedger",
        "balance": 0,
        "availableBalance": 0,
        "blockedAmount": 0,
        "mainLedger": false,
        "bvn": "123432",
        "groupCode": "0000000086",
        "accountID": "0000000338"
    }
}

Path Parameter

Response Body

Request

Request Code Samples

Responses

Get Collection Accounts

Path Parameter#

Response Body#

Request

Request Code Samples

Responses

Path Parameter

Response Body