PAN to Employment Status Lookup
Look up the employment status linked to a PAN number. Useful for income verification and lending risk assessments.
curl -X GET "https://production.deepvue.tech/v1/verification/pan-to-employment-status?pan_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/pan-to-employment-status?pan_number=example_string"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN (JWT)",
"x-api-key": "YOUR_API_KEY"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://production.deepvue.tech/v1/verification/pan-to-employment-status?pan_number=example_string", {
method: "GET",
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("GET", "https://production.deepvue.tech/v1/verification/pan-to-employment-status?pan_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/pan-to-employment-status?pan_number=example_string')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.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": 1751479321051,
"transaction_id": "4b8d6a3e4cc8453989f8f21afa55f084",
"sub_code": "SUCCESS",
"message": "Pan Verified Successfully.",
"data": {
"full_name": "CHANDRA SHEKHAR KANDPAL",
"full_name_split": [
"CHANDRA",
"SHEKHAR",
"KANDPAL"
],
"status": "valid",
"is_sole_proprietor": false,
"is_director": true,
"is_salaried": true
}
}
{
"code": 200,
"timestamp": 1737862347191,
"transaction_id": "142a24d7c61544c080b18d587f2f1767",
"sub_code": "INVALID_PAN_NUMBER",
"message": "Invalid Pan Number."
}
{
"detail": "Inactive client_id"
}
{
"detail": "Not authenticated"
}
{
"detail": "Not a valid token"
}
{
"code": 422,
"timestamp": 1738007665809,
"transaction_id": "fec58bfc47a047b8bac7bfafa17a27d7",
"sub_code": "INVALID_INPUT",
"message": "Invalid Pan Pattern."
}
{
"detail": "Internal Server Error"
}
{
"code": null,
"timestamp": null,
"transaction_id": "string",
"message": "Source Unavailable"
}
/v1/verification/pan-to-employment-status
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 enables you to determine the employment classification associated with a provided PAN (Permanent Account Number). The system identifies whether an individual holds status as a salaried employee, proprietor, or director.
The service verifies PAN details and returns employment categorization data, including the full name of the PAN holder and boolean flags indicating their specific employment status type(s). Successful verification returns the individual's full name (both complete and split into components), validation status, and three boolean indicators: sole proprietor status, director status, and salaried status.
Invalid PAN numbers return a 200 status code with an appropriate sub-code rather than an error code.
Last updated 4 weeks ago
Built with Documentation.AI