Aadhaar Number Verification API

Aadhaar Number Verification API helps verify the validity and status of an Aadhaar number for secure identity authentication. It is commonly used in KYC, banking, telecom, and fintech applications to streamline customer verification processes.

API Details

Request URL

POST

https://g99.in/api/public/aadhaar/verify

Request Body Parameters

Type	Name	Optional	Description
String	AadhaarNumber	Required	The 12-digit Aadhaar number provided as input for identity verification and authentication validation.

Sample Request Payload

request.json

{
  "AadhaarNumber": "123412341234"
}

Request Header Parameters

Type	Name	Value / Description	Optional
String	Content-Type	application/json	Required

Sample Code

request.php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://g99.in/api/public/aadhaar/verify',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "AadhaarNumber": "123412341234"
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

request.py

import requests
import json

url = "https://g99.in/api/public/aadhaar/verify"

payload = json.dumps({
  "AadhaarNumber": "123412341234"
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

request.cs

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://g99.in/api/public/aadhaar/verify");
var content = new StringContent("{\r\n  \"AadhaarNumber\": \"123412341234\"\r\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Response

HTTP status code 200

Key	Type	Description
valid	Boolean	Indicates the Given Aadhaar Number is valid or not.
uuid	String	A unique identifier generated for a specific request, transaction, or verification process to track and manage records securely.
uuidMatches	Boolean	Indicates whether the provided UUID matches the original or stored UUID associated with the request or verification data.

Sample Response

Sample response for valid document

response.json

{
  "valid": true,
  "uuid": "235067435290",
  "uuidMatches": true
}

Error Response

Parameter	Type	Description
status	Number	Unique error codes for different errors. Always available.
message	String	Error message describing the error. Always Available.
error	Boolean	True / False for different errors. Always available.

Error Codes

HTTP Status	Error Code	Error Message
400	4001	Malformed data or missing required parameter values.
400	4002	Invalid Aadhaar Number.
503	5001	Request could not be processed. Please try again later.

Sample Error Response

response.json

{
  "message": "Malformed data or missing required parameter values.",
  "status": 4001,
  "error": True
}