Bank-Aadhaar Seeding Check — Send OTP
Send an OTP to the user's Aadhaar-linked mobile number to initiate the bank-Aadhaar seeding status check.
curl -X POST "https://production.deepvue.tech/v1/verification/bank-aadhaar-seeding/generate-otp?aadhaar_number=example_string" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN (JWT)" \
-H "x-api-key: YOUR_API_KEY"
import requests
import json
url = "https://production.deepvue.tech/v1/verification/bank-aadhaar-seeding/generate-otp?aadhaar_number=example_string"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN (JWT)",
"x-api-key": "YOUR_API_KEY"
}
response = requests.post(url, headers=headers)
print(response.json())
const response = await fetch("https://production.deepvue.tech/v1/verification/bank-aadhaar-seeding/generate-otp?aadhaar_number=example_string", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN (JWT)",
"x-api-key": "YOUR_API_KEY"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("POST", "https://production.deepvue.tech/v1/verification/bank-aadhaar-seeding/generate-otp?aadhaar_number=example_string", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN (JWT)")
req.Header.Set("x-api-key", "YOUR_API_KEY")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://production.deepvue.tech/v1/verification/bank-aadhaar-seeding/generate-otp?aadhaar_number=example_string')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN (JWT)'
request['x-api-key'] = 'YOUR_API_KEY'
response = http.request(request)
puts response.body
{
"code": 200,
"timestamp": 1738007869132,
"transaction_id": "794d863534e64702b0e908fbf6639970",
"sub_code": "SUCCESS",
"message": "OTP Sent Successfully",
"data": {
"aadhaar_number": "825323778091",
"otp_sent": true,
"reference_id": "aadhaar_seeding_status_uWTCaxnFXzAkaAwhimjo"
}
}
{
"detail": "Not authenticated"
}
{
"detail": "Could not validate credentials"
}
{
"detail": "Incorrect client_id or client_secret"
}
{
"code": 422,
"timestamp": 1737873140133,
"transaction_id": "a4aee408393e4711a5267e0c44c25da2",
"sub_code": "INVALID_AADHAAR_NUMBER",
"message": "Invalid Aadhaar Number or Invalid UID. Please enter valid UID."
}
{
"detail": "Internal Server Error"
}
{
"code": 500,
"timestamp": 1729686452911,
"transaction_id": "string",
"sub_code": "SOURCE_FAILURE",
"message": "Source failure. Unable to validate."
}
{
"code": 500,
"timestamp": 1729686452911,
"transaction_id": "string",
"sub_code": "MOBILE_NOT_LINKED_OR_UNABLE_TO_VALIDATE",
"message": "Either mobile number is not linked or unable to validate at the moment."
}
/v1/verification/bank-aadhaar-seeding/generate-otp
ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token (JWT). ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
API Key for authentication. The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
Query Parameters
Responses
Overview
This API triggers an OTP via UIDAI to the Aadhaar-registered mobile number. It serves as part of the Bank Aadhaar Seeding Status verification workflow, where this endpoint handles the OTP generation phase.
The Generate OTP function is the second step in a three-part verification flow:
- Initiate Session — obtain a captcha
- Generate OTP — send a verification code to the Aadhaar-linked mobile number (this endpoint)
- Verify OTP — validate the code and retrieve Aadhaar seeding details
Per UIDAI guidelines, service providers must not share or store Aadhaar numbers, share codes, or XML file contents. Non-compliance invokes penalties under The Aadhaar Act 2016 and related regulations. You must document and retain customer consent before proceeding with verification.
Last updated 4 weeks ago
Built with Documentation.AI