Submit a consumer identity for verification

Submits an identity you collected from a consumer for KYC verification. 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 and the resulting principal_ref. Submissions are idempotent per idempotency_key: resubmitting the same key returns the original submission instead of starting a new verification.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Body for POST /identity-submissions/consumer.

string
required
length between 1 and 255

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

length ≤ 128

Caller-supplied correlation id.

consumer
object
required

The consumer identity to verify.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/vnd.baselayer.v1+json