Docs

Documentation API v1

Build identity verification into your product.

Create a verification session, guide the user through Stile's hosted flow, and make your decision from a signed webhook. The API handles documents, liveness, face match, mobile IDs, and jurisdiction-aware age checks.

  • Document capture
  • Liveness
  • Face match
  • mDL
  • Age tiers
  • Signed webhooks
verification_sessionscurl
POST /v1/verification_sessions
Authorization: Bearer stile_sk_...
Content-Type: application/json

{
  "type": "identity",
  "workflow_id": "wf_checkout"
}
201
verification_session.createdclient_secret ready
verification_session.verifiedsigned webhook delivered

Start with the flow you are building

Each path lands on a complete implementation guide, not a product overview.

Add the hosted widget

Use the drop-in web component, then confirm the result from your server.

Start with the widget

Recognize returning users

Reuse a verified credential when its strength, age tier, and expiry still fit.

Design the reuse flow

Recommended production path

Keep the secret on your server. Trust the webhook.

The browser opens the hosted verification UI. Your server creates the session with a secret key and receives the signed result. Access, fulfillment, and account changes wait for that server-side event.

Read the production integration guide
  1. 1
    Create a workflow

    Choose the use case, methods, and jurisdiction rules in the dashboard.

  2. 2
    Mint a session

    Your backend calls the API and returns the client secret to the widget.

  3. 3
    Run the hosted flow

    The user presents an accepted credential or completes the configured checks.

  4. 4
    Act on the webhook

    Verify the signature, acknowledge quickly, and process the result once.

Browse by task

Jump to the page that answers the decision in front of you.