HomeAbout
Join Today
  • Sign Up
  • Sign In
Conatct Us
HomeAbout
Join Today
  • Sign Up
  • Sign In
Conatct Us
  1. Aadhaar
  • Introduction
  • Getting Started
  • Authentication
  • HTTPS Status Codes
  • Rate Limits
  • Verification Suite
    • Digilocker
      • Initiate
      • Check Status
      • Download Aadhaar
    • Aadhaar
      • Send OTP
        POST
      • Verify OTP
        POST
    • UPI Verification
      POST
    • Bank Verification
      POST
    • PAN Verification
      POST
    • GSTIN Verification
      POST
  • NSDL Account Opening
    • BC Agent Onboarding
      POST
    • Create Account
      POST
    • Account Status
      GET
  • Comunications API
    • Send SMS OTP
      POST
    • Send Whatsapp OTP
      POST
  1. Aadhaar

Verify OTP

POST
/api/v1/aadhaar/verify-otp
Step 2: Verify OTP
Validate the OTP entered by the user and retrieve verified Aadhaar details upon successful verification.

Request

Header Params

Body Params application/json

Example
{
    "request_id": "ADHRVFR17562920251014_421874e5",
    "otp": "324426",
    "aadhaar_number": "997834567654"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1/aadhaar/verify-otp' \
--header 'x-client-id: {{client_id}}' \
--header 'x-client-secret: {{client_secret}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request_id": "ADHRVFR17562920251014_421874e5",
    "otp": "324426",
    "aadhaar_number": "997834567654"
}'

Responses

🟢200Success
application/json
Body

Example
{
    "response_code": 200,
    "status": "success",
    "message": "Aadhaar verification successful — data found",
    "data": {
        "request_id": "ADHRVFR17562920251014_421874e5",
        "status": "verified",
        "aadhaar_details": {
            "aadhaar_uid": "997834567654",
            "full_name": "John Doe",
            "relative_name": "W/O: Roman Doe",
            "date_of_birth": "01/01/1967",
            "gender": "Male",
            "address_details": {
                "address_line": "Malwala, Kot Bakhtu, Talwandi Sabo, Bathinda, Punjab - 151301",
                "house": "",
                "street": "Malwala Kot Bakhtu Talwandi Sabo",
                "location": "",
                "district": "Bathinda",
                "state": "Punjab",
                "country": "India",
                "pincode": "132301"
            },
            "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAgA......"
        }
    },
    "meta": {
        "request_id": "7af70584-653f-44f7-b9a1-c463aea7f544",
        "time": "2025-10-15T20:30:36+05:30"
    }
}
🟠422Validation Error
🟠404Record Not Found
Previous
Send OTP
Next
UPI Verification
Built with