Aadhaar Submit OTP API
Complete Aadhaar e-KYC verification by submitting the 6-digit OTP along with the client_id generated in Step 1. Returns full verified name, gender, date of birth, complete address, pincode, and profile picture.
POST /api/v1/aadhaar/submit_otp
~<500ms Avg Latency
99.9% Uptime SLA
x-api-key Auth
API Overview
Submit OTP received on mobile to fetch full Aadhaar name, gender, DOB, address & photo.
Key Features & Data Points:
- Instant Authoritative Response: Fetches verified official data with ultra-low response latency (~<500ms).
- Clean JSON Standard: Normalized structure across all verification services for effortless enterprise integration.
- Enterprise SLA: Backed by NextStepApi 99.9% uptime architecture and redundant provider failover.
- Secure Header Authentication: Direct authentication via
x-api-keyrequest header.
Request Specification
Headers:
| Header Name | Type | Description |
|---|---|---|
| x-api-key* | string | Your secret production API Key obtained from your NextStepApi dashboard. |
| Content-Type* | string | Must be set to application/json. |
| x-request-id | string | Optional client-generated tracking ID (e.g. REQ12345XYZ) for idempotent logging. |
Request Body (JSON):
| Parameter | Type | Description |
|---|---|---|
| Client_Id* | string | Transaction client ID received from the send_otp response. |
| Otp* | string | 6-digit One Time Password received on registered mobile number. |
Request & Response Examples
Sample Request:
HTTP POST /api/v1/aadhaar/submit_otp
POST /api/v1/aadhaar/submit_otp
x-api-key: your_api_key_here
Content-Type: application/json
{
"Client_Id": "AADHAAR_CLIENT_99812",
"Otp": "123456"
}
Sample Response (200 OK — Sanitized Test Data):
HTTP 200 OK • application/json • <500ms
{
"code": 200,
"status": "success",
"message": "Success",
"request_id": "REQ12345",
"response": {
"request_Id": "REQ12345",
"client_Id": "AADHAAR_CLIENT_99812",
"name": "ROHIT SHARMA",
"gender": "M",
"dob": "1990-01-01",
"address": "MUMBAI MAHARASHTRA",
"zip": "400001",
"profile_Image": "data:image/jpeg;base64,..."
}
}
Business Use Cases
1
Instant Identity Verification
Designed for mission-critical workflows requiring verified real-time data lookups.
2
e-KYC Compliance
Designed for mission-critical workflows requiring verified real-time data lookups.
3
Account Verification
Designed for mission-critical workflows requiring verified real-time data lookups.
4
Customer Verification
Designed for mission-critical workflows requiring verified real-time data lookups.
Integration Steps
1
1. Pass Client_Id from send_otp API
2
2. Pass 6-digit Otp entered by user
3