Quickstart

What is Setu Aadhaar-lite?

Aadhaar Lite lets you pull just the key facts from an Aadhaar record—age bracket, gender, masked mobile number, issuing state and card status—without any extra OTPs or hoops for your users.

Built for plug-and-play integration, it delivers lightning-fast identity checks while keeping sensitive data locked down. You get only what you need, so your workflows stay lean, your users stay private, and your operations stay rock-solid.

What can I do with this product?

Verify Age Eligibility: Ensure users meet minimum age requirements for your service.

Enforce Regional Restrictions: Automatically block or flag requests from locations where your offering isn't permitted.

Streamline Onboarding: Accelerate user registration by instantly validating key identity attributes.

Meet Regulatory KYC Requirements: Stay compliant with local and industry-specific identity verification standards.

Reduce Fraud and Risk: Detect and deter fraudulent or duplicate applications by confirming genuine Aadhaar data.

Here's a quick overview of the Aadhaar Lite API. Additionally, here are the URLs you would need for this API—

• Sandbox—https://dg-sandbox.setu.co
• Production—https://dg.setu.co
• Headers—Contact Setu for providing the credentials required to successfully call Setu APIs. This contains:
  • x-client-id
  • x-client-secret
  • x-product-instance-id

aadhaar-lite

Call this API to verify a user's summarised aadhaar data. A quick explanation of the request param—

• aadhaar_number is the 12- digit aadhaar of the user.

While testing on Sandbox, you may use the following sample values—

• Use 999999990001 for a valid Aadhaar number
• Use 999999990000 for an aadhaar number that has not been found in the UIDAI database.
• If you use any other values for aadhaar_number, you will get a 404 aadhaar not found message.

POST  /api/aadhaar-lite
 
{
    "aadhaar_number": "999999990001"
}   

{
    "status": "SUCCESS",
    "id": "68449359-8db7-4b89-b662-f402a22b9672",
    "message": "Aadhaar found",
    "data": {
        "address": "Delhi",
        "ageBand": "20-30",
        "gender": "M",
        "maskedMobileNumber": "XXXXXX1234"
    },
    "traceId": "1-68186a92-6a10e37431de832b2616c53d"
}    

POST  /api/aadhaar-lite 
 
{
    "aadhaar_number": "999999990001"
}   

{
    "status": "FAILED",
    "id": "95d970cf-e3f9-474f-95a2-1694307b9bb6",
    "message": "Aadhaar not found",
    "traceId": "1-68186bd7-5c07a0a97ca37b2f589950d4"
}    

POST  /api/aadhaar-lite 
 
{
    "aadhaar_number": "99990001"
}   

{
    "status": "FAILED",
    "id": "1bcc51c2-71b2-4db0-9df7-ba9a98c5845f",
    "message": "Invalid Aadhaar number. It must be 12 digits.",
    "traceId": "1-68186c75-5585419254477c03060e573c"
}    

POST  /api/aadhaar-lite 
 
{
    "aadhaar_number": ""
}    

{
    "status": "FAILED",
    "id": "d54a49b5-6776-442b-b353-5c9a28c3de2d",
    "message": "Aadhaar number cannot be empty",
    "traceId": "1-68186cf5-4342e3c74addefc75e7dc10c"
}    

POST  /api/aadhaar-lite 
 
{
    "aadhaar": "999999990001"
}    

{
    "status": "FAILED",
    "id": "7da8cf24-4f48-4f62-a8e6-7c0daa0c1733",
    "message": "Invalid request body. Field 'aadhaar_number' is required.",
    "traceId": "1-68186d54-362bc66046204db412ed1f94"
}