Aadhaar Verification
Validate Aadhaar format, status and identity signals in real time for trusted, consent-based onboarding.
What is the Aadhaar Verification?
The BILAPI Aadhaar Verification API lets you validate an Aadhaar number and its associated identity signals in real time, so you can onboard genuine customers with confidence while staying consent-first and DPDP-aligned.
It is built for banks, NBFCs, fintechs and regulated platforms that need a dependable Aadhaar check inside KYC, account opening and re-KYC flows — returning a clean, predictable JSON response that drops straight into your decisioning.
Every request is encrypted with TLS 1.3, access-controlled and logged, and is billed only on a successful response.
What the Aadhaar Verification returns
Every successful call returns a clean, predictable JSON envelope. The data object includes the fields below (exact fields vary by record availability).
| Field | Description |
|---|---|
aadhaar_ref | A tokenised reference for the Aadhaar that was checked (no raw number echoed). |
status | Validity/active status of the Aadhaar. |
age_band | Age band of the holder where available. |
gender | Gender signal where available. |
state | State associated with the Aadhaar record. |
last_updated | When the underlying record was last refreshed. |
Sample request & response
Call the endpoint with your API key in the X-Bilapi-Api-Key header. The same request shape works in the free sandbox and in production.
POST https://api.bilapi.com/v1/aadhaar-verification
X-Bilapi-Api-Key: <your_api_key>
Content-Type: application/json
{
"aadhaar_number": "XXXXXXXX1234",
"consent": "Y"
}{
"status_code": 200,
"success": true,
"message": "Aadhaar validated",
"data": {
"status": "VALID",
"age_band": "20-30",
"gender": "M",
"state": "Maharashtra"
}
}Key features
Real-time results
Sub-300ms median response so Aadhaar checks never slow your onboarding funnel.
Predictable JSON
The same clean response envelope as every BILAPI endpoint — parse once, reuse everywhere.
Only pay for hits
Invalid inputs and failed lookups are never charged to your wallet.
Secure by design
TLS 1.3 in transit, PII tokenisation at rest and a full audit log on every request.
One key, every API
Sandbox to production on a single key — no per-vendor contracts or integrations.
Built to scale
99.9% uptime target with bulk and webhook-friendly workflows for high volume.
Where it's used
Customer onboarding
Auto-fill and validate identity during signup to cut drop-off and manual review.
Lending & underwriting
Add a verified data point to credit decisions and reduce first-party fraud.
Fraud & risk
Flag mismatches and synthetic identities before they enter your system.
Compliance & audit
Keep a tamper-evident trail of every verification for KYC/AML reviews.
How it works
Create a free account
Sign up on the BILAPI console and get a live API key instantly.
Send a request
POST the required Aadhaar fields to the endpoint with your API key in the header.
Get structured JSON
Receive a clean, predictable JSON response in milliseconds.
Plug into your flow
Drop the result straight into onboarding, underwriting or risk decisioning.
Frequently asked questions
Is the Aadhaar Verification API consent-based?
Yes. The API is designed for consent-first, DPDP-aligned usage — you must capture and pass customer consent, and no raw Aadhaar number is echoed back in the response.
What does it return?
It returns the validity status plus available identity signals such as age band, gender and state as a clean JSON response, with a tokenised reference instead of the raw number.
Who should use this API?
Banks, NBFCs, fintechs and other regulated platforms that need a dependable Aadhaar validation step inside KYC, account opening or re-KYC.
How is my customer's Aadhaar data protected?
Traffic is encrypted with TLS 1.3, sensitive fields are tokenised and access-controlled, and every request is logged. Handling follows India's DPDP principles.
Do failed checks cost money?
No — you are billed only for successful responses from your wallet balance.
Related Aadhaar Verification APIs
Start verifying with BILAPI
One key, a free sandbox and a predictable JSON envelope across every endpoint.