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": "rahman+1@gmail.com",
  "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
Example:

"rahman+1@gmail.com"

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[]