Skip to main content
POST
/
v1
/
create-account
Create a new bank account
curl --request POST \
  --url https://staging-vouchers.ventogram.com/api/v1/create-account \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Api-User: <api-key>' \
  --data '
{
  "bvn": "46444443431",
  "currency": "NGN",
  "email": "[email protected]",
  "firstName": "rahmann",
  "lastName": "plus",
  "middleName": "one",
  "phone": "+2348033333511",
  "dob": "25-02-2000",
  "country": "NG",
  "stateOfOrigin": "Lagos",
  "stateOfResidence": "Lagos",
  "lgaOfOrigin": "Amuwo",
  "lgaOfResidence": "Ifako",
  "addressLine1": "27 Obafemi Awolowo Way",
  "addressLine2": "",
  "addressLine3": ""
}
'
{
  "success": true,
  "message": "bank account successfully completed",
  "data": [
    {
      "bankCode": "",
      "bankName": "Test Bank",
      "accountName": "TEST-MANAGED-ACCOUNT",
      "accountNumber": "1238314012",
      "currency": "NGN"
    }
  ]
}

Authorizations

​
X-Api-User
string
header
required
​
X-Api-Key
string
header
required

Body

application/json
​
bvn
string
required
Example:

"46444443431"

​
currency
string
required
Example:

"NGN"

​
email
string<email>
required
​
firstName
string
required
Example:

"rahmann"

​
lastName
string
required
Example:

"plus"

​
middleName
string
required
Example:

"one"

​
phone
string
required

phone number starting with +234

Example:

"+2348033333511"

​
dob
string
required

Date of birth in dd-mm-yyyy format

Example:

"25-02-2000"

​
country
string
required
Example:

"NG"

​
stateOfOrigin
string
required
Example:

"Lagos"

​
stateOfResidence
string
required
Example:

"Lagos"

​
lgaOfOrigin
string
required
Example:

"Amuwo"

​
lgaOfResidence
string
required
Example:

"Ifako"

​
addressLine1
string
required
Example:

"27 Obafemi Awolowo Way"

​
addressLine2
string
Example:

""

​
addressLine3
string
Example:

""

Response

Bank account successfully created

​
success
boolean
Example:

true

​
message
string
Example:

"bank account successfully completed"

​
data
object[]