Submit KYC

Submit KYC information for verification

POST

texttext

/api/v2/kyc/submit

Submits KYC information (personal data + document references) for review.

Request Body

userIdstringrequired

OZZOBiT user ID

firstNamestringrequired

Legal first name

lastNamestringrequired

Legal last name

dateOfBirthstringrequired

Date of birth (YYYY-MM-DD)

countryCodestringrequired

ISO country code of residence

nationalitystringrequired

ISO country code of nationality

addressobjectrequired

Object with line1, line2, city, state, postCode, country

documentTypestringrequired

PASSPORT | DRIVERS_LICENSE | NATIONAL_ID

documentNumberstringrequired

Document number

documentExpirystring

Expiry date (YYYY-MM-DD)

documentCountrystringrequired

Issuing country ISO code

Response Schema

submissionIdstring

KYC submission ID

statusstring

SUBMITTED | PENDING_REVIEW

Example

jsonjson

POST /api/v2/kyc/submit
{
  "userId": "OZZOBiT_user_abc",
  "firstName": "John", "lastName": "Doe",
  "dateOfBirth": "1990-05-15",
  "countryCode": "US", "nationality": "US",
  "address": { "line1": "123 Main St", "city": "New York", "state": "NY", "postCode": "10001", "country": "US" },
  "documentType": "PASSPORT",
  "documentNumber": "AB1234567",
  "documentExpiry": "2030-01-01",
  "documentCountry": "US"
}
// Response: { "submissionId": "kyc_sub_123", "status": "SUBMITTED" }