myAadhaar API | Aadhaar OTP & e-KYC Verification Gateway

ENTERPRISE IDENTITY GATEWAY

High-Speed Aadhaar OTP & e-KYC Verification

Automate user identity verification with instant mobile OTP generation, structured demographic retrieval, and enterprise security with zero concurrent session locks.

SERVICE HIGHLIGHTS

⚡ DISPATCH SPEED: Sub-second Response

👤 DEMOGRAPHICS: Full Name, Address, Photo

🛡️ AUTH GATE: x-api-key + Bearer Token

🔒 SESSION SAFETY: Auto Revoked & Cleaned

⚡

Seamless OTP Dispatch

Reliable OTP delivery directly to the resident's Aadhaar-linked mobile number with automatic retry management.

👤

Complete Demographics

Receive structured resident data including full name, local language script, DOB, gender, mobile, address, and photo.

🛡️

Enterprise Security

Session isolation with safe token masking and automatic session release preventing duplicate login blocks.

🚀

Developer-First REST API

Clean, predictable JSON responses with comprehensive SDK examples in cURL, Python, and Node.js.

📖 Developer API Reference PUBLIC & FREE ACCESS

Integrate Aadhaar OTP verification and demographic retrieval with two simple REST endpoints.

SECURITY HEADERS

Include these headers in every API request:

x-api-key: cwid-live-key-12345
Authorization: Bearer cwid-secure-token-67890
Content-Type: application/json

POST /api/v1/aadhaar/otp/send

Generates a new verification session and dispatches the OTP to the registered mobile number.

Request Payload (JSON):

{
  "aadhaarNumber": "987654321098"
}

Response Payload (JSON):

{
  "success": true,
  "sessionId": "cwid-8492018593",
  "aadhaar": "987654321098",
  "attempts": 1,
  "message": "OTP successfully generated"
}

cURL Example:

curl -X POST https://myaadhar.corewaveit.in/api/v1/aadhaar/otp/send \
  -H "Content-Type: application/json" \
  -H "x-api-key: cwid-live-key-12345" \
  -H "Authorization: Bearer cwid-secure-token-67890" \
  -d '{"aadhaarNumber": "987654321098"}'

POST /api/v1/aadhaar/otp/verify

Validates the 6-digit OTP, completes verification, retrieves demographics & photo, and releases the session.

Request Payload (JSON):

{
  "sessionId": "cwid-8492018593",
  "otp": "537608"
}

e-KYC Response Payload (JSON):

{
  "isValid": true,
  "aadhaarNumber": "987654321098",
  "name": "Rahul Ramesh Sharma",
  "localName": "राहुल रमेश शर्मा",
  "dob": "1998-05-14",
  "gender": "MALE",
  "mobile": "9876543210",
  "careOf": "S/O: Ramesh Sharma",
  "address": {
    "full": "Flat 402, Lotus Heights, MG Road, Shivaji Nagar, Pune, Maharashtra - 411005",
    "landmark": "Near Shivaji Garden",
    "villageTownCity": "Pune",
    "subDistrict": "Haveli",
    "district": "Pune",
    "state": "Maharashtra",
    "pincode": "411005"
  },
  "photoBase64": "/9j/4AAQSkZJRg...",
  "sessionRevoked": true
}

cURL Example:

curl -X POST https://myaadhar.corewaveit.in/api/v1/aadhaar/otp/verify \
  -H "Content-Type: application/json" \
  -H "x-api-key: cwid-live-key-12345" \
  -H "Authorization: Bearer cwid-secure-token-67890" \
  -d '{"sessionId": "cwid-8492018593", "otp": "537608"}'

Python Integration Example:

import requests

BASE_URL = "https://myaadhar.corewaveit.in"
HEADERS = {
    "Content-Type": "application/json",
    "x-api-key": "cwid-live-key-12345",
    "Authorization": "Bearer cwid-secure-token-67890"
}

# 1. Send OTP
send_res = requests.post(f"{BASE_URL}/api/v1/aadhaar/otp/send", json={
    "aadhaarNumber": "987654321098"
}, headers=HEADERS).json()

session_id = send_res["sessionId"]
print(f"OTP Sent! Session ID: {session_id}")

# 2. Verify OTP
otp_code = input("Enter OTP: ")
verify_res = requests.post(f"{BASE_URL}/api/v1/aadhaar/otp/verify", json={
    "sessionId": session_id,
    "otp": otp_code
}, headers=HEADERS).json()

if verify_res.get("isValid"):
    print("Verified Name:", verify_res["name"])
    print("Full Address:", verify_res["address"]["full"])
else:
    print("Error:", verify_res.get("error"))

⚡ Live e-KYC Test STEP 1

Enter 12-Digit Aadhaar Number

INIT VERIFICATION SESSION

SECURE HANDSHAKE COMPLETED

DISPATCH OTP TO MOBILE

VERIFY OTP & AUTH TOKEN

RETRIEVE FULL PROFILE & PHOTO

AUTO-RELEASE SESSION (REVOKED)

📊 Live Results & Payloads ACTIVE GATEWAY

Payload Logs

// Ready for incoming payload...

High-Speed Aadhaar OTP & e-KYC Verification

Admin Portal Login

FULL NAME