PAN Verification

Validate a PAN (Permanent Account Number) and retrieve the holder's name and status.

Endpoint

POST /vas-api/pan-validation-v1

Authentication

Requires OAuth2 Bearer token. Get your credentials →

Request

Headers

Header	Type	Required	Description
Authorization	string	Yes	Bearer YOUR_ACCESS_TOKEN
Content-Type	string	Yes	application/json

Body parameters

Field	Type	Required	Description	Example
pan	string	Yes	10-character PAN number (5 letters + 4 digits + 1 letter)	ABCDE1234F

Example request

curl

curl -X POST https://api.api4business.com/vas-api/pan-validation-v1 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"pan": "ABCDE1234F"}'

Python

import requests

response = requests.post(
  "https://api.api4business.com/vas-api/pan-validation-v1",
  headers={
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  json={"pan": "ABCDE1234F"}
)
print(response.json())

Node.js

const response = await fetch(
  "https://api.api4business.com/vas-api/pan-validation-v1",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_ACCESS_TOKEN",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({ pan: "ABCDE1234F" })
  }
);
const data = await response.json();
console.log(data);

Java

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
  .uri(URI.create("https://api.api4business.com/vas-api/pan-validation-v1"))
  .header("Authorization", "Bearer YOUR_ACCESS_TOKEN")
  .header("Content-Type", "application/json")
  .POST(HttpRequest.BodyPublishers.ofString("{\"pan\": \"ABCDE1234F\"}"))
  .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response

Success (200)

Field	Type	Description
ok	boolean	true if the request was successful
responseCode	number	HTTP status code
message	string	Status message
body.panName	string	Full name on the PAN card
body.panNumber	string	The PAN number that was verified
body.panStatus	string	Status of the PAN (Active, Inactive, etc.)

Example response

{
  "ok": true,
  "responseCode": 200,
  "message": "Transmission OK",
  "body": {
    "panName": "SAMPLE ENTERPRISE PRIVATE LIMITED",
    "panNumber": "ABCDE1234F",
    "panStatus": "Active"
  }
}

Response headers

Header	Description
x-request-id	Unique request identifier for tracing and support

Error responses

Status	Error Code	Message	Resolution
400	400	Invalid PAN	Check that the PAN is exactly 10 alphanumeric characters (AAAAA9999A format)
400	400	Invalid Request	Verify the request body is valid JSON with a pan field
401	401	Invalid Credentials	Check your access token — it may be expired or invalid
429	429	Quota Violation	Rate limit exceeded — implement exponential backoff and retry
500	500	Internal Server Error	Retry after a short delay. Contact support if persistent
503	503	Service Not Available	Upstream service temporarily unavailable. Retry with backoff

Error response format

{
  "errorCode": 400,
  "errorType": "proxy",
  "errorMessage": "Invalid PAN"
}

Rate limits

Standard rate limits apply. See Rate Limits for details.

Related

• KYC API Overview
• Compliance Status (206AB)
• Authentication Guide
• Error Handling Guide