Bank-Aadhaar Seeding Check — Verify OTP
Verify the OTP to confirm whether the user's bank account is linked to their Aadhaar number.
curl -X POST "https://production.deepvue.tech/v1/verification/bank-aadhaar-seeding/verify-otp?otp=example_string&reference_id=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/verify-otp?otp=example_string&reference_id=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/verify-otp?otp=example_string&reference_id=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/verify-otp?otp=example_string&reference_id=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/verify-otp?otp=example_string&reference_id=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": "0bc39fb5e3674a2397b0065f2f5e72ee",
"sub_code": "SUCCESS",
"message": "OTP Verified Successfully",
"data": {
"bank_name": "STATE BANK OF INDIA",
"status": "Active",
"last_updated_date": "2013-06-01",
"reference_id": "aadhaar_seeding_status_hTirlZjnEuedfjwKPgRo"
}
}
{
"detail": "Not authenticated"
}
{
"detail": "Could not validate credentials"
}
{
"detail": "Incorrect client_id or client_secret"
}
{
"code": 422,
"timestamp": 1729686452911,
"transaction_id": "string",
"sub_code": "OTP_ALREADY_SUBMITTED",
"message": "OTP Already submitted"
}
{
"code": 422,
"timestamp": 1738007863352,
"transaction_id": "def6aeb00dc54929bca35cec7e471a7e",
"sub_code": "INVALID_OTP",
"message": "Invalid OTP."
}
{
"code": 422,
"timestamp": 1729686452911,
"transaction_id": "string",
"sub_code": "INVALID_REFERENCE_ID",
"message": "Invalid Reference ID"
}
{
"detail": "Internal Server Error"
}
{
"code": 500,
"timestamp": 1729686452911,
"transaction_id": "string",
"sub_code": "SOURCE_FAILURE",
"message": "Source failure. Unable to validate."
}
/v1/verification/bank-aadhaar-seeding/verify-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 validates the OTP entered by the user to authenticate with UIDAI. Upon successful validation, the response includes the user's Bank Aadhaar Seeding Status details, including the bank name associated with the Aadhaar account, seeding status, last updated date, and a reference identifier for the transaction.
The verification process is part of the larger Aadhaar authentication workflow. Users submit an OTP that was previously sent to their Aadhaar-linked mobile number by UIDAI. The API confirms the OTP validity and retrieves the associated banking information.
UIDAI regulations strictly prohibit sharing, publishing, or displaying Aadhaar numbers, share codes, or XML file contents. Non-compliance invokes legal action under multiple sections of The Aadhaar Act and related regulations. You must maintain records of user consent before proceeding with verification.
Last updated 4 weeks ago
Built with Documentation.AI