Initializes KYB process for a business customer

POST 
/v1/compliance/kyb

Initializes Know Your Business (KYB) verification for a business customer. Validates business onboarding data, creates an Alloy journey application, and attempts auto-approval via the EXTERNAL_KYB strategy.

Prerequisites:

• Business customer must exist with KYB data populated

Note: UBO (Ultimate Beneficial Owner) KYC approval is NOT required to start KYB. UBO KYC is validated at auto-approval time — you can start KYB and upload documents while individual KYC is still in progress.

Request

application/json

Body

required

customerId stringrequired

The ID of the customer in question

Responses

200

KYB process started successfully

application/json

Schema

Schema

message string

data

object

onboardingId string

Business onboarding ID

status string

Possible values: [PENDING, PROCESSING, APPROVED, DENIED_COMPLIANCE, DENIED_IDENTITY_THEFT, EXPIRED]

Current business onboarding status

traceId string

Example (from schema)

{
  "message": "string",
  "data": {
    "onboardingId": "string",
    "status": "PENDING"
  },
  "traceId": "string"
}

Loading...