Get a balance
curl --request GET \
--url https://{host}/v1/accounts/{accountNumber}/balance \
--header 'X-Api-Key: <api-key>'const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://{host}/v1/accounts/{accountNumber}/balance', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{host}/v1/accounts/{accountNumber}/balance"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"message": "<string>",
"request_id": "01a1775167aa7693a7acd8df7b596118",
"data": {
"account_number": "<string>",
"currency": "NGN",
"balance_minor": 123,
"updated_at": "2023-11-07T05:31:56Z",
"restriction": {
"code": "<string>",
"reason": "<string>",
"since": "2023-11-07T05:31:56Z"
}
},
"code": "13"
}{
"success": true,
"message": "<string>",
"request_id": "01a1775167aa7693a7acd8df7b596118",
"data": {
"fields": {}
},
"code": "13"
}{
"success": true,
"message": "<string>",
"request_id": "01a1775167aa7693a7acd8df7b596118",
"data": null,
"code": "13"
}Accounts
Get a balance
What the account holds now, in kobo.
Required permission: accounts:read, feature:TRANSACTIONS
GET
/
v1
/
accounts
/
{accountNumber}
/
balance
Get a balance
curl --request GET \
--url https://{host}/v1/accounts/{accountNumber}/balance \
--header 'X-Api-Key: <api-key>'const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://{host}/v1/accounts/{accountNumber}/balance', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{host}/v1/accounts/{accountNumber}/balance"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"message": "<string>",
"request_id": "01a1775167aa7693a7acd8df7b596118",
"data": {
"account_number": "<string>",
"currency": "NGN",
"balance_minor": 123,
"updated_at": "2023-11-07T05:31:56Z",
"restriction": {
"code": "<string>",
"reason": "<string>",
"since": "2023-11-07T05:31:56Z"
}
},
"code": "13"
}{
"success": true,
"message": "<string>",
"request_id": "01a1775167aa7693a7acd8df7b596118",
"data": {
"fields": {}
},
"code": "13"
}{
"success": true,
"message": "<string>",
"request_id": "01a1775167aa7693a7acd8df7b596118",
"data": null,
"code": "13"
}