Create Person: Required Fields for USD Account Request

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 name
  • name_last- Last name
  • name_other- Middle or other name (as seen on international passport)
  • phone- Valid mobile number
  • email- User’s email address
  • dob- Date of birth (YYYY-MM-DD)
  • id_level- For USD accounts, must be "primary" (International Passport)
  • id_number- Passport number
  • id_country- Country that issued the passport
  • bank_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 details
  • 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.

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 name
  • name_last- Last name
  • name_other- Middle or other name (as seen on international passport)
  • phone- Valid mobile number
  • email- User’s email addressl
  • dob- Date of birth (YYYY-MM-DD)
  • id_level- For USD accounts, must be "primary" (International Passport)
  • id_number- Passport number
  • id_country- Country that issued the passport
  • 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": "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"
        }
  ]
}
'