Organization Verify (KYB Initiation)

Initiate KYB verification for an organization

Organization Verify (KYB Initiation)

Starts a business verification flow using BUSINESS_VERIFICATION and TENANT_VERIFIED.

Endpoint

POST /api/v2.1/customer/organization/{organizationId}/verify

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

X-User-ID string required

User executing privileged organization action

X-User-Roles string required

Comma-separated roles (example: ADMIN_USER,COMPLIANCE_OFFICER)

Request 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"
}

Success Response

200

json

{
  "code": 200,
  "data": {
    "verificationId": "ac0d408e-06b8-420c-9876-745db4ea4c98",
    "status": "PENDING",
    "verificationType": "KYB"
  },
  "message": "Success"
}