apyhub
Back
▣ DATA VALIDATION · HR

Validate Aadhaar API

Hosted on ApyHub

What it does

The Aadhaar validation API checks whether a 12-digit Aadhaar number is valid. Send the number as an aadhaar string in the request body, digits only with no spaces or dashes, and get back a boolean data field: true for a valid number, false otherwise.

Use it as the first check in an Indian KYC or onboarding flow. It catches typos and malformed input at the form, so the number that reaches your Aadhaar verification provider is one worth sending. That matters when each OTP or eKYC verification call is billed, and when failed attempts add friction for the user.

Typical uses for the Aadhaar validation API include customer onboarding for fintech and lending apps, employee records in HR and payroll systems, seller and partner registration on commerce platforms, and bulk cleanup of Aadhaar numbers already stored in a database. Support teams and admin dashboards can use the same call to check a number before editing a record.

This API validates the number itself. It does not connect to UIDAI or confirm that the number belongs to the person submitting it, so pair it with an authentication provider when you need identity proof.

Indian onboarding forms usually collect more than one identifier. Validate the address with the Indian Pincode Validation API, bank details with the IFSC Code Validation API, and the mobile number with the Phone Number Validation API.

POST
Validate an Aadhaar number
https://api.eu.apyhub.com/apyhub/validate-aadhaar-number

QUICKSTART

GUIDE

Quickstart

Validate a 12-digit Aadhaar number by sending it in a JSON body.

curl -X POST "https://api.eu.apyhub.com/apyhub/validate-aadhaar-number" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"aadhaar":"568095088801"}'

What you'll get back

Returns a JSON object with a data boolean field — true when the Aadhaar number is valid, false otherwise.

{
  "data": true
}
TRY ITLIVE · 5 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
12-digit Aadhaar number (numeric digits only).

About this endpoint

What it does

Validates an Aadhaar number sent in the request body. The response returns a JSON object containing a data boolean that indicates whether the Aadhaar number is valid.

Request Body

ParameterTypeDescription
aadhaarString12-digit Aadhaar number, numeric digits only.

Response

Returns a JSON object with a data boolean field. true indicates the Aadhaar number is valid; false indicates it is not.

ParameterTypeDescription
dataBooleanValidation result for the Aadhaar number.
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.