Submit a consumer + business identity for verification

Submits a consumer identity together with the business they operate for KYC + KYB verification and evaluation of the operator link between them. Verification runs asynchronously: the request is accepted with a 202 and a submission id — poll GET /identity-submissions/{submission_id} or subscribe to the OnboardingSession.completed webhook for the outcome, the principal_ref, and the business_ref. Submissions are idempotent per idempotency_key.

post/identity-submissions/consumer-business

Request

Base URL
https://api.baselayer.com
Auth
API key in header X-API-Key
TypeScript
https://skmtc.dev/baselayer/apis/baselayer-api-service/docs/identity-submissions/consumer-business/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

idempotency_keystring required

Caller-chosen key making the submission idempotent: a resubmission under the same key returns the original submission instead of minting a second session.

reference_idstring nullable

Caller-supplied correlation id.

Response

submission_idstring uuid required

Unique id of the accepted submission — the handle for status polling, and the session id the OnboardingSession.completed webhook carries.

Lifecycle state of an asynchronous verification workflow, such as an identity submission: PENDING, EXECUTING, or WAITING while in flight, then a terminal COMPLETED, FAILED, EXPIRED, or CANCELLED.