Skip to main content
POST
/
v1
/
ramp
/
subaccount
/
{subaccountId}
/
verification
/
tier-one
curl --request POST \
  --url https://api.bullring.finance/v1/ramp/subaccount/{subaccountId}/verification/tier-one \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "first_name": "eli",
  "last_name": "dan",
  "date_of_birth": "24-05-1983",
  "identification_number": "22245678123",
  "address": {
    "street": "13, muilli street",
    "city": "ikeja",
    "state": "lagos",
    "postal_code": "100001",
    "country": "GH"
  },
  "phone": {
    "phone_country_code": "+234",
    "phone_number": "1234194590"
  }
}
'
{
  "storeId": "c625ca4e-b125-47fd-b090-7c63f51c1630",
  "status": "approved",
  "verified": true,
  "verificationId": "tier1_verification_ngn_1763593659002_m0w0no",
  "processingTimeMs": 6,
  "createdAt": "2025-11-19T23:07:39.008Z"
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
subaccountId
string<uuid>
required

The unique identifier of the subaccount

Example:

"6a0fd7af-181d-4c0f-b24b-b8cfb739d67a"

Body

application/json

Other Countries Tier One Verification e.g Nigeria, Ghana, Zambia, etc.

​
first_name
string
required
Example:

"eli"

​
last_name
string
required
Example:

"dan"

​
date_of_birth
string
required
Example:

"24-05-1983"

​
identification_number
string
required

BVN, NIN can be passed to identification_number

Example:

"22245678123"

​
address
object
required
​
phone
object
required

Response

Verification completed successfully

​
verificationId
string

Unique identifier for the verification

​
storeId
string

Subaccount ID

​
status
string

Verification status

​
verified
boolean

Whether the verification was successful

​
processingTimeMs
integer

Time taken to process the verification in milliseconds

​
createdAt
string<date-time>

Verification creation timestamp