Skip to main content
POST
/
v1
/
kyc
/
customers
/
{verificationId}
/
submit
Tier Two (API)
curl --request POST \
  --url https://api.bullring.finance/v1/kyc/customers/{verificationId}/submit \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "id": "8e1984e4-6e5f-4bea-a79f-03d321b051be",
  "signed_agreement_id": "b88347e6-f0c9-4dce-810e-f65301412b7b",
  "status": "active",
  "email": "[email protected]",
  "has_accepted_terms_of_service": true,
  "bridgeCustomerId": "790e9944-49f8-45b3-ac60-b605f13a07db",
  "lastSubmissionAt": "2025-11-21T15:18:49.039Z",
  "type": "individual",
  "first_name": "Dafe",
  "middle_name": null,
  "last_name": "Aror",
  "phone": "+234 8012345678",
  "address": {
    "street_line_1": "9 Karimu Street",
    "street_line_2": "",
    "city": "Lagos",
    "state": "LA",
    "postal_code": "105102",
    "country": "NGA"
  },
  "birth_date": "1993-01-24",
  "account_purpose": "payments_to_friends_or_family_abroad",
  "account_purpose_other": null,
  "employment_status": "employed",
  "expected_monthly_payments_usd": "FROM_5000_TO_9999",
  "acting_as_intermediary": false,
  "most_recent_occupation": "ACCOUNTANT_AND_AUDITOR",
  "source_of_funds": "inheritance",
  "identifying_information": [
    {
      "type": "passport",
      "issuing_country": "NGA",
      "number": "12345678909",
      "image_front": "https://res.cloudinary.com/bullring-finance/image/upload/v1763738198/verification/2025-11-21/t2fgqlxesqigmm0qfvbi.png",
      "image_back": "https://res.cloudinary.com/bullring-finance/image/upload/v1763738205/verification/2025-11-21/n0slzbkhxreppmqew4yd.png"
    }
  ],
  "store_id": "a3b53d4d-7a47-4e53-bfdd-74f9630248d4"
}'
{}

Authorizations

x-api-key
string
header
required

Path Parameters

verificationId
string<uuid>
required

The unique identifier of the verification

Body

application/json
id
string<uuid>
signed_agreement_id
string<uuid>
status
string
email
string<email>
has_accepted_terms_of_service
boolean
bridgeCustomerId
string<uuid>
lastSubmissionAt
string<date-time>
type
enum<string>
Available options:
individual,
business
first_name
string
middle_name
string | null
last_name
string
phone
string
address
object
birth_date
string<date>
account_purpose
string
account_purpose_other
string | null
employment_status
string
expected_monthly_payments_usd
string
acting_as_intermediary
boolean
most_recent_occupation
string
source_of_funds
string
identifying_information
object[]
store_id
string<uuid>

Response

Success

The response is of type object.