Skip to content

Published services, current details, and clear categories.

Explore APIs
KYC12 APIsPopular

Aadhaar Verification API

Confirm a customer's Aadhaar identity in a consent-led flow, and use the structured result inside your own onboarding journey.

Consent capturedpurpose · customer onboardingcns_7dK2QpAADHAARXXXX XXXX 4321one-time codeentered by the customeraadhaar_numberXXXX XXXX 4321MASKED AT SOURCE***first eight digits never returned
Request and response

You confirm the required fields and consent steps with us during onboarding.

You send

An Aadhaar number with a consent record, plus the details to compare or the code the holder releases

You receive

A structured status, a match outcome, and released identity details on the Advanced tier. Available fields vary by data source and record.

Coverage
India, in a consent-led flow. Eligibility and tier depend on the selected service contract.
Typical users
Lenders and NBFCs, fintech and payment platforms, insurers, telecom operators, staffing and gig platforms
Coverage note
Consent-led only. Eligibility, tier and returned detail depend on the selected service contract.
Overview

What you can do with the Aadhaar Verification API

Aadhaar verification confirms that the Aadhaar identity a customer presents is in a usable state. It also checks that the details they have given match the record held against it, in a flow the holder authorizes first. It is the check most Indian onboarding journeys are built around. An API puts that check inside your own application. Your product captures consent and the required details, and the request goes to a trusted data source. A structured result comes back for your flow to route on. Nobody has to read a document image that arrived by email. Basic and Advanced coverage differ in how much the holder releases. What each can return depends on the selected service contract, and available fields vary by data source and record.

  • Consent comes first and stays attached

    The check is designed to run only after the holder has authorized it for a stated purpose. The consent record, the request and the result stay together. A reviewer can see all three later.

  • What an Aadhaar check returns

    A structured status, a match outcome for customer-supplied details, and on the Advanced tier the identity details the holder releases along with a masked reference. The fields available may vary by data source and by record.

  • Every outcome has a route

    A decline, an unreachable mobile number and a mismatch each come back as a distinct result. Your journey can offer an alternative document path instead of dead-ending on a retry.

  • Store a masked reference in place of the number

    The masked reference is designed to be kept instead of the full Aadhaar number. Your systems then hold what the workflow needs, without collecting sensitive data you have to protect.

How it works

The five-step Aadhaar Verification API workflow

Our team walks you through the exact request and response for this service during onboarding.

Step 1

Capture informed consent

Show the purpose in your own interface and record the customer's authorization for it. Keep the consent record joined to the request that follows.

Step 2

Send the number and the details to compare

Send the Aadhaar number with the details your flow needs compared, or start the holder-authorized step where the selected tier supports it.

Step 3

Complete the holder-authorized step

On the Advanced tier, the customer enters the one-time code sent to the mobile number attached to their record. That releases the details for the stated purpose.

Step 4

Take the status and match outcome

Your application receives the status, the match outcome and any released details in a structured response, ready to handle in code.

Step 5

Route the customer and store the outcome

Proceed, ask for an alternative officially valid document, or send the case to a reviewer. Retain the outcome with a masked reference, not the full identity.

Industries

Where teams use Aadhaar Verification API

These sectors build the check into a decision they already make.

  • Lending and NBFC

    Settle applicant identity before underwriting begins

  • Fintech and PSP

    Establish identity before account limits are raised

  • Insurance

    Confirm the proposer identity on a new proposal

  • Telecom

    Verify a subscriber before a connection is activated

  • Staffing and gig platforms

    Verify a worker before the first shift

  • Healthcare

    Keep patient records attached to the right person

What is Aadhaar verification?

Aadhaar verification is the step where you confirm that the Aadhaar identity a customer presents is in a usable state. You also check that the details the customer gave match the record held against it.

Most Indian digital onboarding journeys are built around this check, because Aadhaar is the credential the widest set of customers already holds.

The check is consent-led by design. Nothing runs until the holder has authorized it for a stated purpose, and what comes back is limited to what that authorization covers. A verification service carries a consented request to a trusted data source, and it does not open a window onto a government system.

How the Aadhaar Verification API works

Handled by hand, the check means collecting a document image, keying the details in and hoping a reviewer caught the mismatch. That work does not scale, and it fails quietly.

An API moves the same check inside your own application. Your product captures consent and the required details, then submits the request.

It receives a structured response your flow can route on: proceed, ask for something else, or send the case to a reviewer. The customer stays in one journey.

What you send with an Aadhaar check

A request starts from the Aadhaar number the customer submits, with the consent record for that purpose. Where your flow only checks consistency, you send the customer-supplied name and date of birth too, and the response reports the comparison outcome.

The holder-authorized step adds the one-time code sent to the mobile number attached to the customer's record. The customer enters it to release details for the stated purpose. Available fields vary by data source and record, and the response may report a match outcome in place of the underlying values.

Basic and Advanced coverage compared

CapabilityBasicAdvanced
Confirms the submitted number is well formed and in a usable stateIncludedIncluded
Returns a structured status your flow can route onIncludedIncluded
Reports a match outcome for customer-supplied name and date of birthIncludedIncluded
Runs the holder-authorized step that releases identity detailsNot includedIncluded
Returns released demographic details such as name, date of birth and addressNot includedIncluded
Returns a masked reference you can store in place of the full numberNot includedIncluded

Which tier applies, and what each can return, depends on the selected service contract.

Who runs Aadhaar checks at onboarding

Lending and NBFC platforms can settle an applicant's identity at the top of a loan application. That stops underwriting time going into a file that will not survive verification.

Fintech and payment service providers can run the check when a limited account is upgraded. Transaction limits or a payout account depend on identity being established.

Insurers can confirm the proposer's identity on a proposal. The policy record and any later claim then rest on details checked at the start.

Telecom operators can settle identity before a connection is activated, since the subscriber record has to hold up long after the sale.

Staffing and gig platforms can verify a rider, driver or field worker before the first shift. The platform is accountable for who it puts in front of customers. Healthcare providers can resolve a returning patient to one record and avoid a history split across near-identical names.

Designing the Aadhaar step in your journey

Write the consent screen in language a customer can actually read, and keep what they agreed to joined to the request that followed. A verification you cannot trace back to an authorization is hard to defend later.

Design the paths that are not a clean pass. A customer may have no mobile number attached to their record, may not receive the code, or may decline. Each is an outcome to route, and each needs an alternative document path.

Store the decision, not the identity. Most workflows need the outcome, the timestamp and a masked reference, and holding more only increases what you have to protect.

Aadhaar is sensitive personal information and carries obligations beyond ordinary customer data. Run a check only against consent that was informed, specific to the stated purpose, and revocable. Retain a masked reference in place of the full number, restrict access to the people whose work requires it, and keep retention to what the process needs.

Do not repurpose a result. Details released for onboarding are not a dataset for profiling, marketing or enrichment. Always offer an alternative officially valid document to a customer who declines.

Your business stays responsible for the notices it shows, the purposes it claims and the obligations of its own sector.

FAQ

Common questions

What teams ask before they integrate Aadhaar Verification API.

It lets your business run a consent-led Aadhaar check inside its own application, instead of collecting a document image and reviewing it by hand. Your product submits the request and receives a structured result it can act on directly.

Get started

Add Aadhaar Verification API to your workflow

Tell us how you plan to use it. Our team sets up API access, agrees your pricing and takes you through onboarding.