Pan Basic V1

Post  https://api.aopay.co.in/api/AOP/V1/Validation/PanBasic

The PanBasic API is designed to validate the basic details of a PAN (Permanent Account Number) card holder. It verifies the PAN number against official government records and returns the holder’s name, PAN status, and whether the provided name matches the one in the PAN database. This API is particularly useful for financial institutions, fintech platforms, and KYC verification services where accurate PAN information is critical.

Body Parameters
{
 "PanNumber" : "JRXXS9XX0D",
 "FirstName" :"Tester",
 "RegistrationID" : "AOP-554"
}
Request Parameters
Name Type Description
PanNumber String 10-character alphanumeric PAN to be validated.
FirstName String First name of the individual or entity associated with the PAN.
RegistrationID String Unique registration identifier, often tied to the user.
Responses

200

200

Response

200

RESPONSE BODY

Json

401

401

Response

401

RESPONSE BODY

Object

status     boolean

response_code     integer

message     string

Did this page help you?     Yes    No

Language
shell Shell
python Python
node Node
c# C#
php PHP

cURL

curl --location -request POST 'https://api.aopay.co.in/api/AOP/V1/Validation/PanBasic' \
--data  '{
  "PanNumber": "JRXXS9XX0D",
  "FirstName": "Tester",
  "RegistrationID": "AOP-554"
}'
                                
import requests

url = 'https://api.aopay.co.in/api/AOP/V1/Validation/PanBasic'

payload = json.dumps({
"PanNumber": "JRXXS9XX0D",
"FirstName": "Tester",
"RegistrationID": "AOP-554"
}) 
headers = {
  "Content-type" : "application/json"
}

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

print (response.text)
                                
var requests = require("request");
var options = { 
  "method" : "POST",
  "url" : 'https://api.aopay.co.in/api/AOP/V1/Validation/PanBasic',
  "headers" : {
      "Content-Type" : 'application/json'
    },
    body: JSON.stringify({
     "PanNumber": "JRXXS9XX0D",
     "FirstName": "Tester",
     "RegistrationID": "AOP-554"
    }) 
}; 
request(options, function(error, response){
   if(error) throw new Error(error);
   console.log(response.body); 
}); 
                                
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post,'https://api.aopay.co.in/api/AOP/V1/Validation/PanBasic')
var content = new StringContent(
  "{
   "PanNumber": "JRXXS9XX0D",
   "FirstName": "Tester",
   "RegistrationID": "AOP-554"
  }",
  null,"application/json"
);

request.Content = content;
var response =  await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
                                
<?php
$curl =  curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL =>  'https://api.aopay.co.in/api/AOP/V1/Validation/PanBasic',
  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 =>  '{
    "PanNumber": "JRXXS9XX0D",
    "FirstName": "Tester",
    "RegistrationID": "AOP-554"
  }',
  CURLOPT_HTTPHEADER =>  array(
    'Content-Type: application/json'
  ),
));
$response =  curl_exec($curl);
curl_close($curl);
echo $response;

RESPONSE

200

401

-Result

Example

{
    "result": {
    "pan": "JRXXS9XX0D",
    "status":"Active",
            "name": "Tester",
            "name_match": true
                                                                   
            }, 
            "http_response_code": 200,
            "request_id": "a2b9b6b6-f2b9-41ef-ac7c-36f382e88223",
            "client_ref_num": "TERF53517",
            "result_code": 101
            "Status": "FALSE",
            "message": "",
            "Value": ""   
}
                                
{
  "status": false,
  "response_code": 5,
  "message": "Invalid signature encoding"
}