Nani API Documentation

Verify users with document checks, liveness, and decisioning — one API, a hosted flow your users complete, and a console your team trusts.

Getting started

Create verification sessions from your backend, send users to the hosted verify_url, and receive signed webhooks when a decision is ready. Start with the quickstart, then explore the API reference.

Core concepts

Sessions — A single verification attempt for one end-user. Each session has a verify_url, required steps, and a final decision.

Identities — The verified person (or business) stored in your tenant vault after a successful session.

Tierstier1 (document), tier2 (+ liveness), tier3 (+ proof of address). Country rules determine exact steps.

Webhooks — Async notifications when sessions complete (session.approved, session.rejected, and more).

Guides

Quickstart

Create your first session and handle the webhook.

Read more

KYC flow

Integrate the hosted verification flow end to end.

Read more

Webhooks

Verify signatures and handle session events.

Read more

Errors

HTTP status codes and error response format.

Read more

Was this page helpful?