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

​
GET /v1/accounts/balance

​
Response body

​
code
string
required

Response code

​
description
string
required

Response description

​
data
object
​
amount
string
required

Account balance.

​
currency
string
required

Currency code.

​
timeCreated
string
required

Account 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"
  }
}
Creating virtual accountsTerminal assignment