API Reference

Create Person: Required Fields for NGN Account Request

To request an NGN bank account for an individual, you must first create a person with the following required fields:

  • name_first- First name
  • name_last- Last name
  • name_other- Middle or other name (as shown on government-issued ID)
  • phone- Valid mobile number
  • email- User’s email address
  • dob- Date of birth (YYYY-MM-DD)
  • id_level- For NGN accounts use
    • "primary" for International Passport
    • "secondary" for local IDs (e.g. NIN, Voter’s Card, Driver’s License)
  • id_type - Must be one of: "passport", "drivers_license", "nin", "voters_card"
  • id_number- ID number based on the selected id_type
  • id_country- Country that issued the ID (typically "NG" for Nigeria)
  • bank_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": "secondary",
  "id_type": "drivers_license",
  "kyc_level": "basic",
  "address": {
    "line1": "Juncal 2091",
    "line2": "B1648",
    "city": "Tigre",
    "state": "Lagos",
    "country": "NG",
    "postal_code": "100276"
  },
  "name_first": "takeshi",
  "name_last": "kovacs",
  "phone": "2348024056288",
  "email": "[email protected]",
  "dob": "1989-01-16",
  "id_number": "98374273242",
  "id_country": "NG",
  "bank_id_number": "67283476223",
  "documents": [
    {
      "type": "drivers_licence",
      "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"
    }
  ]
}
'