Accounts
Fetching account balance
Accounts
Checkout
Transfers
Terminals
Webhooks
Transactions
Products
Accounts
Fetching account balance
Learn about fetching account balances
curl --request POST \
--url https://api.nomba.com/v1/accounts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'accountId: <accountid>' \
--data '{
"accountRef": "1oWbJQQHLyQqqf1SwxjSpudeA21",
"phoneNumber": "2348188667581",
"email": "[email protected]",
"bvn": "12234412345",
"pin": "1234",
"accountName": "Daniel Scorsese",
"currency": "NGN",
"callbackUrl": "https://webhook.site/98ef100f-5adc-4434-800a-0808h60bd8d7",
"expiryDate": "2023-12-06T15:46:43.000Z"
}'
{
"code": "00",
"description": "Success",
"data": {
"createdAt": "2023-09-04T07:09:06.900Z",
"accountId": "fc81b80e-e607-4b86-8591-840925191733",
"accountHolderId": "01a10aeb-d989-460a-bbde-9842f2b4320f",
"accountRef": "1oWbJQQHLyQqqf1SwxjSpudeA21",
"phoneNumber": "2348188667581",
"email": "[email protected]",
"bvn": "12234412345",
"status": "ACTIVE",
"type": "virtual",
"accountName": "Daniel Scorsese",
"currency": "NGN",
"callbackUrl": "https://webhook.site/98ef100f-5adc-4434-800a-0808h60bd8d7",
"expiryDate": "2023-12-06T15:46:43.000Z"
}
}
Parent account balance
Fetch the parent’s account balance
Sub account balance
Fetch sub account balance
GET /v1/accounts/balance
Response body
code
string
requiredResponse code
description
string
requiredResponse description
data
object
amount
string
requiredAccount balance.
currency
string
requiredCurrency code.
timeCreated
string
requiredAccount creation timestamp.
curl --request POST \
--url https://api.nomba.com/v1/accounts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'accountId: <accountid>' \
--data '{
"accountRef": "1oWbJQQHLyQqqf1SwxjSpudeA21",
"phoneNumber": "2348188667581",
"email": "[email protected]",
"bvn": "12234412345",
"pin": "1234",
"accountName": "Daniel Scorsese",
"currency": "NGN",
"callbackUrl": "https://webhook.site/98ef100f-5adc-4434-800a-0808h60bd8d7",
"expiryDate": "2023-12-06T15:46:43.000Z"
}'
{
"code": "00",
"description": "Success",
"data": {
"createdAt": "2023-09-04T07:09:06.900Z",
"accountId": "fc81b80e-e607-4b86-8591-840925191733",
"accountHolderId": "01a10aeb-d989-460a-bbde-9842f2b4320f",
"accountRef": "1oWbJQQHLyQqqf1SwxjSpudeA21",
"phoneNumber": "2348188667581",
"email": "[email protected]",
"bvn": "12234412345",
"status": "ACTIVE",
"type": "virtual",
"accountName": "Daniel Scorsese",
"currency": "NGN",
"callbackUrl": "https://webhook.site/98ef100f-5adc-4434-800a-0808h60bd8d7",
"expiryDate": "2023-12-06T15:46:43.000Z"
}
}