...
A developer integrating the identity verification API

Identity Verification API: KYC Sessions in One REST Call

Create a verification session with one POST, send the customer to our Web SDK widget, and read the result from the same session. Document checks, face match and liveness run inside it, and every check comes back named, with its own result.

Read the API DocsAPI docs
  • REST API and Web SDK REST + SDK
  • JWT and permanent access tokens JWT · Tokens
  • Named checks in the response Named checks
  • Public error reference Error reference

12,000 free verifications when you first connect

Every company connecting to NeuroVision for the first time gets 12,000 free verifications for 12 months. Available from December 1, 2026.

Learn more

Independently tested and certified

ISO register global certification markASIB certification markQA Compliance Assessment certification mark
  • ISO/IEC 27001:2022
  • GDPR
  • iBeta ready
Global coverage

16,000+ document types
from 195+ countries and territories

Customers verify with the ID they actually carry — in 90+ languages, including handwritten fields and MRZ.

16,000+

document types


Passport ID card Driver's licence Residence permit Visa Work permit Voter card Tax ID eID Biometric passport Military ID Health card National ID Travel document Refugee ID Social security card
195+

countries and territories


Kazakhstan UAE Germany United Kingdom Singapore India Brazil Nigeria Philippines Vietnam Türkiye Mexico Uzbekistan Egypt Indonesia France Spain Italy Poland Kenya Saudi Arabia Japan South Korea Australia United States Canada Thailand Malaysia South Africa
Quick start

Your First Verification in Five Steps

  1. 01Get a tokenPOST /user/login returns a temporary JWT for your account.
  2. 02Create a sessionPOST /kyc/session/create with the scenario you configured.
  3. 03Open the widgetSend the user to the Web SDK widget by link or QR code.
  4. 04Read the resultPoll the session status, or receive the callback you set.
  5. 05Go liveTest the flow in the sandbox, then connect real users.
Everything here is documentedEach step matches a method in the public API reference, under the same name.
How it works
Endpoints

What the Identity Verification API Covers

Five groups of methods, and a widget that uses them.

Names below are the ones in our public reference, so you can find each method without guessing what we called it on a landing page.

KYC sessions

Create a session, check its status, list sessions, filter them and download the log archive.

8 methods

Access tokens

Create a permanent token, list the tokens a user holds, update one or delete it.

4 methods

Users and balance

Authorize a user and get a temporary JWT, read the group balance or update it.

3 methods

Persons

Create person lists and person records, update, delete, and add images to a stored face.

8 methods

Data sources

Create sources and source groups, list them, update and delete.

8 methods

Web SDK

Install the widget, pass parameters, and work with the client key that ties it to a session.

4 pages
Developers

Call the API in One Request

A session is created with one POST. The widget takes it from there, and your backend reads the result when it is ready.

terminalREST API
curl -X POST $NV_API_URL/kyc/session/create \  -H "Content-Type: application/json" \  -H "Authorization: Bearer $JWT" \  -d '{"token":"$JWT","schemaId":"schema-001"}'Example only — see the docs for the full request body.
errors{ "status": …, "message": "…", "details": … }
Trust and data

Where Your Data Lives and Stays

Run the checks in our cloud, or inside your own perimeter.

ISO/IEC 27001:2022Certified security system
  • JWT for every call
  • Permanent access tokens
  • On-premises deployment
  • You set image retention
Web SDK

The Web SDK Widget Your Users Actually See

The widget runs on top of your page and walks the customer through the document photo, the selfie and the checks, then sends the result to you.

Works in the browser they have

All modern browsers on desktop and mobile, iOS and Android included. The only permission the widget asks for is access to the camera.

No app download needed

Tied to a session by key

The client key connects the widget on your page to the session you created, which is how the result finds its way back to you.

Start by link or QR code

The user opens a start screen and scans a QR code or follows a link, and can switch the interface language before they begin.

You decide which steps run

Document, selfie with document, liveness and anti-fraud steps are switched on and off in your scenario, not in the widget code.

The Web SDK widget: start screen, document capture and result

The widget is documented in four pages, from installation to the client key.

Results

Reading the Result of a Session

Two ways to get it, and one format to read it in.

Each check comes back as a named item with its own status and confidence value, so your rules can read the parts you care about instead of a single verdict.

Poll the session status

Ask for the session by its id or by the client key and read the current state and results.

Pull

Receive the callback

A callback delivers the final result when the session finishes, so you do not have to poll it.

Push

Named checks with confidence

Document and face checks come back as named items — each with a status and a confidence value.

JSON

Every error has a code

A failed check returns a code and a description from our public reference, so support can tell the customer what to do.

40 codes
Access

Tokens, Access and Errors

Temporary and permanent tokens

A login returns a temporary JWT with a lifetime you choose. For server-to-server work you create permanent access tokens and revoke them when you no longer need them.

Errors you can act on

Forty documented codes with a description for each, covering image quality, document problems, fraud signals and face checks — so a rejection can be explained to the customer.

See the error reference

Session logs you can download

A session can be exported as a log archive through the API, so an audit or a dispute is answered from your own copy rather than from a screenshot.

Read the API docs

Every method here is in the reference

Each endpoint, field and error code on this page appears in our public documentation under the same name, so you can go from the example straight to the reference page that describes it.

Why us

Why teams choose NeuroVision Global Systems

Accuracy you can audit

Independently tested face matching, a confidence score on every result.

Accuracy you can audit

The face algorithm was tested by NIST and placed TOP-24, NIST FRVT 1:1 Verification. Every document and face result comes with a confidence score.

TOP-24NIST FRVT 1:1 Verification
0.1 sper face comparison

Live in under an hour

REST API, Web SDK, iOS and Android SDK, WebView; sandbox first.

Live in under an hour

Under an hour for REST API or Web SDK with sandbox keys; production in one business day. A 14-day trial on your real traffic comes with full support.

< 1 hto integrate with sandbox keys
14 daystrial with full API access

Global coverage

195+ countries and territories, 16,000+ document types, 90+ languages.

Global coverage

Customers verify with the ID they actually carry: 16,000+ document types from 195+ countries and territories, including handwritten fields and MRZ.

16,000+document types
90+languages

Anti-fraud built on real attacks

40+ document checks, 1:N face search, blacklist screening, 30 more layers.

Anti-fraud built on real attacks

Deepfake-resistant liveness, 1:N deduplication and blacklist screening on top of document checks — one person, one account.

40+document checks
0.01%residual fraud risk

Privacy by design

ISO/IEC 27001:2022, GDPR-ready; on-premises, cloud or hybrid.

Privacy by design

Run it in our cloud, in your data centres or hybrid — templates and personal data never leave your jurisdiction.

27001:2022ISO/IEC certified
GDPRready

In-house engines only

OCR, face, liveness and anti-fraud are ours.

In-house engines only

One vendor covers KYC, KYB, AML and KYT on one API — one SLA, no third-party licences.

20 yearsof computer-vision engineering
1 SLAfor every check
Pricing

Identity Verification API Pricing

The API is not a separate product with its own licence. You pay per completed check.

Document package

From $0.25 per check

Document recognition and anti-fraud checks. Add selfie and liveness with the Basic package. Build your own set in the calculator.

Calculate your price

Pay as you go

No subscription and no licence fee for the API — you pay per completed check.

See Pricing

Free trial

A 14-day trial on your real traffic with full API access and sandbox access from day one.

Volume and enterprise

Custom terms for high volumes, on-premises deployment and an SLA.

Products

Our AI-Powered Identity Solutions

Everything you need to verify, authenticate, and protect your customers — all in one powerful platform.

A real person with a real document — verified in seconds. Document capture, face match, liveness, anti-fraud and AML.

Learn more

Screen every customer against sanctions, PEP and watchlists, including self-exclusion lists — inside the same verification flow.

Learn more

Verify the business behind the account: company registry data and ultimate beneficial owners (UBO), checked before onboarding.

Learn more

Transaction monitoring in real time: suspicious transfers are flagged for review, on the same API as KYC and AML.

Learn more

A real, present person — deepfake-resistant. Authenticate returning customers by face instead of passwords.

Learn more

Payments confirmed with a face or an ID document — the identity your customer already verified, at checkout.

Learn more
Contacts

Get Your API Keys

Tell us what you are building and which checks you need. We will send sandbox credentials and put you in touch with the engineer who will help you go live.

Prefer to reach out directly?
Name *
Please enter a valid name
Company
E-mail *
Please enter a valid e-mail
Phone
Please enter a valid phone
Your Message (optional)
Please accept the privacy policy
FAQ

Identity Verification API FAQ

What developers ask before they start. The full reference is in the documentation, and we link to it.

Didn’t find your answer?

A login returns a temporary JWT, and you can also create permanent access tokens for server-to-server calls. Both are described in the API reference.

Yes, for the final result of a session. You can also poll the session status by its id or by the client key.

Age checks run in the same session; see the age verification API.

We do not publish rate limits. Tell us the volume you are planning and we will confirm it for your case.

A named check with its status, plus an error code and description from our public error reference — enough for your support team to tell the customer what to do next.

AML screening comes back the same way — as a named check; see the AML API.

Yes. You test the integration in the sandbox before you connect real data, and our integration team helps you through the first session.

There is no separate API licence. You pay per completed check, from $0.25 for document recognition with anti-fraud. Build your own set on the pricing page.

All-in-One Face Recognition Platform
for Instant KYC Verification

Streamline onboarding, prevent fraud, and ensure KYC/AML compliance