Search GSTIN By PAN

Testing Data

PAN

State Code

Response

Remark

AAACJ3770E

24

200

Success response

AAACS8577K

08

503

Source Unavailable response

Test URL

get
Search GSTIN By PAN

https://api.sandbox.co.in/gsp/public/pan/:pan
Returns list of GSTIN entities for given PAN
Request
Response
Request
Path Parameters
pan
required
10-character alpha-numeric unique identifier for tax payer
Headers
Authorization
required
string
JWT Authentication token
x-api-key
required
string
Public key required to authorize API access
x-api-version
optional
string
‚Äč
Query Parameters
state_code
required
string
GST state code
Response
200: OK
Success
No records found
Invalid GSTIN / UID
Success
{
"data": [
{
"data": {
"stjCd": "GJ009",
"dty": "Regular",
"stj": "Ghatak 9 (Ahmedabad)",
"lgnm": "JOHN DOE PRIVATE LIMITED",
"adadr": [],
"cxdt": "",
"gstin": "24AAACJ3770E2ZZ",
"nba": [
"Service Provision"
],
"lstupdt": "14/04/2018",
"ctb": "Private Limited Company",
"rgdt": "01/07/2017",
"pradr": {
"addr": {
"bnm": "ABC Lakeview Tower",
"st": "Opp. Vastrapur Lake",
"loc": "Vastrapur",
"bno": "123",
"stcd": "Gujarat",
"dst": "",
"city": "",
"flno": "",
"lt": "",
"pncd": "380015",
"lg": ""
},
"ntr": "Service Provision"
},
"ctjCd": "WS0601",
"sts": "Active",
"tradeNam": "John Doe Private Limited",
"ctj": "RANGE I"
}
}
],
"code": 200,
"timestamp": 1614696176218,
"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"
}
No records found
{
"data": {
"error_code": "NOGSTIN",
"message": "No records found"
},
"code": 200,
"timestamp": 1614696176218,
"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"
}
Invalid GSTIN / UID
{
"data": {
"error_code": "SWEB_9035",
"message": "Invalid GSTIN / UID"
},
"code": 200,
"timestamp": 1614696176218,
"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"
}
403: Forbidden
Access denied
Invalid token
Insufficient credits
Access denied
{
"code": 403,
"message": "Access denied",
"timestamp": 1614696176218,
"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"
}
Invalid token
{
"code": 403,
"message": "Invalid access token",
"timestamp": 1614696176218,
"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"
}
Insufficient credits
{
"code": 403,
"message": "Insufficient credits",
"timestamp": 1614696176218,
"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"
}
422: Unprocessable Entity
Invalid Pan Number
Invalid Pan Number
{
"code": 500,
"message": "Invalid Pan pattern",
"timestamp": 1614696176218,
"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"
}
500: Internal Server Error
{
"code": 500,
"message": "Internal Server Error",
"timestamp": 1614696176218,
"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"
}

JWT Authorization token can be obtained by calling the Authenticate API

Example Request

cURL
Java
cURL
curl --location --request GET 'https://api.sandbox.co.in/gsp/public/pan/AAACJ3770E?state_code=24' \
--header 'Authorization: eyJhbGciOiJIUzUxMiJ9.eyJhdWQiOiJBUEkiLCJyZWZyZXNoX3Rva2VuIjoiZXlKaGJHY2lPaUpJVXpVeE1pSjkuZXlKaGRXUWlPaUpCVUVraUxDSnpkV0lpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1Gd2FWOXJaWGtpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1semN5STZJbUZ3YVM1eGRXbGphMjh1WTI5dElpd2laWGh3SWpveE5Ua3dPVFk1TmpBd0xDSnBiblJsYm5RaU9pSlNSVVpTUlZOSVgxUlBTMFZPSWl3aWFXRjBJam94TlRVNU16UTNNakF3ZlEueHNmYkhQTERFRlRvTy1OUWdaUUpLM25OUjFxdlhvWmhaOHRqS3gzSExydjZiVkJaMHpJZEZ5ai1MUTg1YnJZS0xXQnFnZHlzZ1NDSXlDUXNtV2VOYkEiLCJzdWIiOiJqb2huQGRvZS5jb20iLCJhcGlfa2V5Ijoia2V5X2xpdmVfQWRlKioqKioqKioqKioqKioqKioqKioqKioqKipVeHMiLCJpc3MiOiJhcGkucXVpY2tvLmNvbSIsImV4cCI6MTU5MTA1NjAwMCwiaW50ZW50IjoiQUNDRVNTX1RPS0VOIiwiaWF0IjoxNTkwOTY5NjAwfQ.nH23CR5RHGQ0U19I_vq3vyJ_85A1a2iEMQij5QHgJQdDuS9x7FmTidsr1CQabSFF5ujE40SFxHv1gJM20TauUw' \
--header 'x-api-key: key_live_Ade**************************Uxs' \
--header 'x-api-version: 3.4.0'
Java
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
Request request = new Request.Builder()
.url("https://api.sandbox.co.in/gsp/public/pan/AAACJ3770E?state_code=24")
.method("GET", null)
.addHeader("Authorization", "eyJhbGciOiJIUzUxMiJ9.eyJhdWQiOiJBUEkiLCJyZWZyZXNoX3Rva2VuIjoiZXlKaGJHY2lPaUpJVXpVeE1pSjkuZXlKaGRXUWlPaUpCVUVraUxDSnpkV0lpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1Gd2FWOXJaWGtpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1semN5STZJbUZ3YVM1eGRXbGphMjh1WTI5dElpd2laWGh3SWpveE5Ua3dPVFk1TmpBd0xDSnBiblJsYm5RaU9pSlNSVVpTUlZOSVgxUlBTMFZPSWl3aWFXRjBJam94TlRVNU16UTNNakF3ZlEueHNmYkhQTERFRlRvTy1OUWdaUUpLM25OUjFxdlhvWmhaOHRqS3gzSExydjZiVkJaMHpJZEZ5ai1MUTg1YnJZS0xXQnFnZHlzZ1NDSXlDUXNtV2VOYkEiLCJzdWIiOiJqb2huQGRvZS5jb20iLCJhcGlfa2V5Ijoia2V5X2xpdmVfQWRlKioqKioqKioqKioqKioqKioqKioqKioqKipVeHMiLCJpc3MiOiJhcGkucXVpY2tvLmNvbSIsImV4cCI6MTU5MTA1NjAwMCwiaW50ZW50IjoiQUNDRVNTX1RPS0VOIiwiaWF0IjoxNTkwOTY5NjAwfQ.nH23CR5RHGQ0U19I_vq3vyJ_85A1a2iEMQij5QHgJQdDuS9x7FmTidsr1CQabSFF5ujE40SFxHv1gJM20TauUw")
.addHeader("x-api-key", "key_live_Ade**************************Uxs")
.addHeader("x-api-version", "3.4.0")
.build();
Response response = client.newCall(request).execute();