Individual person creation
To request a USD bank account for an individual, you must first create a person with the following required fields:
name_first
- First namename_last
- Last namename_other
- Middle or other name (as seen on international passport)phone
- Valid mobile numberemail
- User’s email addressdob
- Date of birth (YYYY-MM-DD)id_level
- For USD accounts, must be "primary" (International Passport)id_number
- Passport numberid_country
- Country that issued the passportbank_id_number
- BVN (Bank Verification Number)address
Object with all required address fields (line1, city, state, country, postal_code)background_information
- Object containing required background/KYC detailsdocuments
- Object with all required document uploads (e.g. passport scan, utility bill)
🚧 Note: All fields are required. Omitting any will result in an error response during person creation.
Individual person creation (UBO)
To request a USD bank account for a business, you must first create a person (UBO) with the following required fields:
name_first
- First namename_last
- Last namename_other
- Middle or other name (as seen on international passport)phone
- Valid mobile numberemail
- User’s email addressldob
- Date of birth (YYYY-MM-DD)id_level
- For USD accounts, must be "primary" (International Passport)id_number
- Passport numberid_country
- Country that issued the passportbank_id_number
- BVN (Bank Verification Number)address
Object with all required address fields (line1, city, state, country, postal_code)documents
- Object with all required document uploads (e.g. passport scan, utility bill)
🚧 Note: All fields are required. Omitting any will result in an error response during person creation.
curl --request POST \
--url https://api.useoval.com/person \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"id_level": "primary",
"id_type": "passport",
"kyc_level": "basic",
"address": {
"line1": "Juncal 2091",
"line2": "B1648",
"city": "Tigre",
"state": "Lagos",
"country": "NG",
"postal_code": "B7000"
},
"background_information": {
"employment_status": "employed",
"occupation": "QA Engineer",
"primary_purpose": "personal",
"source_of_funds": "salary",
"expected_monthly_inflow": 1000
},
"name_first": "takeshi",
"name_last": "kovacs",
"name_other": "koo",
"phone": "2348024056288",
"email": "[email protected]",
"dob": "1989-01-16",
"id_number": "98374273242",
"id_country": "NG",
"bank_id_number": "67283476223",
"documents": [
{
"type": "passport",
"url": "https://res.cloudinary.com/rapidpay-africa/image/upload/v1682887473/sandbox/DRIVERS_LICENSE_dpf491.png",
"issue_date": "2010-01-01",
"expiry_date": "2030-01-01"
},
{
"type": "bank_statement",
"url": "https://res.cloudinary.com/rapidpay-africa/image/upload/v1742226747/dummy_q5dttk.pdf",
"issue_date": "2010-01-01",
"expiry_date": "2030-01-01"
}
]
}
'
curl --request POST \
--url https://api.useoval.com/person \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"id_level": "primary",
"id_type": "passport",
"kyc_level": "basic",
"address": {
"line1": "Juncal 2091",
"line2": "B1648",
"city": "Tigre",
"state": "Lagos",
"country": "NG",
"postal_code": "B7000"
},
"name_first": "takeshi",
"name_last": "kovacs",
"name_other": "koo",
"phone": "2348024056288",
"email": "[email protected]",
"dob": "1989-01-16",
"id_number": "98374273242",
"id_country": "NG",
"bank_id_number": "67283476223",
"documents": [
{
"type": "passport",
"url": "https://res.cloudinary.com/rapidpay-africa/image/upload/v1682887473/sandbox/DRIVERS_LICENSE_dpf491.png",
"issue_date": "2010-01-01",
"expiry_date": "2030-01-01"
},
{
"type": "bank_statement",
"url": "https://res.cloudinary.com/rapidpay-africa/image/upload/v1742226747/dummy_q5dttk.pdf",
"issue_date": "2010-01-01",
"expiry_date": "2030-01-01"
}
]
}
'