Create Verification

Initiate KYC/KYB verification requests

Create Verification

Creates a verification request for individual or organization onboarding.

Endpoint

POST /api/v2.1/verifications

Common Defaults

requestedLevel: TENANT_VERIFIED
B2C type: IDENTITY_VERIFICATION
B2B type: BUSINESS_VERIFICATION

Required Headers

X-Forwarded-For string required

Client source IP (runner default: 127.0.0.1)

X-Tenant-ID string required

Tenant identifier

X-Forwarded-From string required

Client source identifier (runner default: integration-client)

platform string required

Client platform (runner default: web)

deviceId string required

Device identifier (runner default: integration-device)

Authorization string required

Bearer token

B2C Example

json

{
  "customerId": "2dac1793-ab48-420c-b0b5-01292302e188",
  "type": "IDENTITY_VERIFICATION",
  "requestedLevel": "TENANT_VERIFIED",
  "requestedByUserId": "0d488f57-57ef-4f9a-88a6-f89121cab838",
  "requestedByTenantId": "97e7ff29-15f3-49ef-9681-3bbfcce4f6cd",
  "notes": "Identity Verification"
}

B2B Example

json

{
  "customerId": "f458d016-56bb-43a6-856c-4d0456b2c38c",
  "type": "BUSINESS_VERIFICATION",
  "requestedLevel": "TENANT_VERIFIED",
  "requestedByUserId": "da9a15d2-1eb9-4804-a812-b58b03f33018",
  "requestedByTenantId": "97e7ff29-15f3-49ef-9681-3bbfcce4f6cd",
  "notes": "Business Verification"
}

Response Example

200

json

{
  "code": 200,
  "data": {
    "verificationId": "825f84a5-a709-4e58-a80f-b51871d94cfb",
    "status": "PENDING",
    "verificationType": "KYC"
  },
  "message": "Success"
}