v1

latestOpenAPI 3.0.02026-07-247150151.6 KB
KYC

Start KYC (Know-Your-Customer)

Start a KYC verification for a Customer

post/customers/{customer_id}/verification-kyc

Request body

dobstring string

Date of birth in YYYY-MM-DD format.

program_idstring required

String in acceptable UUID format that corresponds to a valid Program program_id.

ssnstring required

Must be in ######### or ###-##-#### format

phonestring required

Numbers only or dash-separated are acceptable

phone_country_codestring required

Must be a string of 1-3 digits

emailstring required

Must be a valid email address

ipstring required

Must be dot separated

kyc_retry_requestboolean

If failure threshold has been reached, set this to true to request further attempts

Example request

{
  "dob": "1980-04-04",
  "program_id": "72585109-8222-4221-b15b-48e87ffed790",
  "ssn": "123-45-6789",
  "phone": "555-111-2222",
  "phone_country_code": "1",
  "email": "customer@bond.tech",
  "ip": "257.134.1.57"
}

Response

customer_idstring required
kyc_statusstring required

Example response

{
  "customer_id": "2df10ec1-130f-41bb-b0cf-f3af48350eb7",
  "kyc_status": "submitted"
}