PAN to GSTIN

Look up all GSTINs registered against a PAN number. Returns the list of linked GSTINs with their registration status and state codes — useful for discovering all GST registrations of a business entity across states.

Endpoint

GET /vas-api/v1/pan-to-gstin

Authentication

Requires OAuth2 Bearer token. Get your credentials →

Request

Headers

Header	Type	Required	Description
Authorization	string	Yes	Bearer YOUR_ACCESS_TOKEN

Query parameters

Parameter	Type	Required	Description	Example
pan	string	Yes	10-character PAN number	ABCDE1234F

Example request

curl

curl -X GET "https://api.api4business.com/vas-api/v1/pan-to-gstin?pan=ABCDE1234F" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Python

import requests

response = requests.get(
  "https://api.api4business.com/vas-api/v1/pan-to-gstin",
  params={"pan": "ABCDE1234F"},
  headers={"Authorization": "Bearer YOUR_ACCESS_TOKEN"}
)
print(response.json())

Node.js

const response = await fetch(
  "https://api.api4business.com/vas-api/v1/pan-to-gstin?pan=ABCDE1234F",
  { headers: { "Authorization": "Bearer YOUR_ACCESS_TOKEN" } }
);
console.log(await response.json());

Java

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
  .uri(URI.create("https://api.api4business.com/vas-api/v1/pan-to-gstin?pan=ABCDE1234F"))
  .header("Authorization", "Bearer YOUR_ACCESS_TOKEN")
  .GET().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 successful
responseCode	number	HTTP status code
message	string	Status message
body.panNum	string	The PAN that was queried
body.gstinResList	array	List of GSTINs registered against this PAN
body.gstinResList[].gstin	string	15-character GSTIN
body.gstinResList[].authStatus	string	Registration status (Active, Cancelled, Suspended)
body.gstinResList[].stateCd	string	State code (e.g., 27 for Maharashtra, 29 for Karnataka)

Example response

{
  "ok": true,
  "responseCode": 200,
  "message": "Transmission OK",
  "body": {
    "panNum": "ABCDE1234F",
    "gstinResList": [
      {
        "gstin": "29ABCDE1234F1Z5",
        "authStatus": "Active",
        "stateCd": "29"
      },
      {
        "gstin": "27ABCDE1234F1Z3",
        "authStatus": "Active",
        "stateCd": "27"
      }
    ]
  }
}

Response headers

Header	Description
x-request-id	Unique request identifier — log this for debugging and support

Error responses

Status	Error Code	Message	Resolution
400	400	Invalid PAN	Check PAN is 10 characters (5 alpha + 4 digits + 1 alpha)
400	400	Invalid Request	Verify the pan query parameter is present
401	401	Invalid Credentials	Access token expired — request a new one
429	429	Quota Violation	Rate limit exceeded — retry with backoff
500	500	Internal Server Error	Retry after delay
503	503	Service Not Available	GSTN service temporarily down — retry

Related

• GSTIN Status — Get full details for a specific GSTIN
• PAN Verification — Validate the PAN itself
• PAN to CIN — Find company registration by PAN
• GST Overview