Skip to main content
Use this step after the user has verified their email (OTP) or wallet (signed challenge). StarkFi returns session details you use to send the user to the hosted KYC experience.
Prerequisite: Prepare + email OTP, or Prepare wallet. If identity is not verified yet, the API responds with 403 identity_not_verified.

Endpoint


Request body

Provide email or wallet (same identifier used in prepare):

Example (email)

Example (wallet)


Responses

201 — Session created or returned

The exact shape of data can vary when a session already exists or the user is already approved. Read session_url to open the hosted flow and session_id to correlate status checks.

403 — Identity not verified

403 — User not prepared

429 — Quota exceeded

status: verify_quota_exceeded — monthly KYC session quota exhausted.

404 — Unsupported path

status: method_not_found — the kyc_type in the URL is not supported.