Smart API Zone

Aadhaar Verification (OTP Request)

Endpoint Version: 1.0.0 | Cost: ₹2.00 per call

Endpoint Route

POST https://api.rsprint.site/api/v1/gateway/aadhaar-otp

Description

Initiate Aadhaar Verification process by requesting an OTP sent to the linked mobile number.

Request Headers

Header Name	Value / Type	Description
Content-Type	`string`	application/json
X-API-Key	`string`	your_api_key

Request Parameters (JSON Body)

Parameter Name	Required Type	Constraint
aadhaar	`string`	12-digit Aadhaar Number

Response Headers

Header	Sample Value
Content-Type	application/json; charset=utf-8
X-Execution-Time-Ms	45.82 ms

Error Codes mapping

Error Code	Description / Scenario
INVALID_AADHAAR	The Aadhaar number is invalid.
GATEWAY_TIMEOUT	The verification partner endpoint was unreachable.

Code Integration

cURL Request Shell

NodeJS Axios Integration

const axios = require('axios');

axios.post('https://api.rsprint.site/api/v1/gateway/aadhaar-otp', {
    "aadhaar": "123456789012"
}, {
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'X-API-Secret': 'YOUR_API_SECRET'
  }
}).then(res => console.log(res.data));

Python Requests Integration

import requests

url = 'https://api.rsprint.site/api/v1/gateway/aadhaar-otp'
headers = {
    'X-API-Key': 'YOUR_API_KEY',
    'X-API-Secret': 'YOUR_API_SECRET'
}
response = requests.post(url, json={"aadhaar":"123456789012"}, headers=headers)
print(response.json())

PHP cURL Integration

<?php

$url = 'https://api.rsprint.site/api/v1/gateway/aadhaar-otp';
$headers = [
    'X-API-Key: YOUR_API_KEY',
    'X-API-Secret: YOUR_API_SECRET',
    'Content-Type: application/json'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"aadhaar":"123456789012"}');

$res = curl_exec($ch);
echo $res;

Sample Success Response

{
    "status": "success",
    "message": "OTP sent to registered mobile ending with XXXX-1234",
    "data": {
        "reference_id": "ref_987654321"
    }
}

Sample Error Response

{
    "status": "error",
    "message": "Invalid Aadhaar number"
}