PAN to GSTIN lookup

This API aims to search for all possible GSTINs for given PAN. We hit more than 40 APIs calls on an average to find accurate results. That’s the reason this is a long-running task (or an asynchronous call). The response of the request is a reference ID.

Given a reference ID, you could fetch its status using Status API. In order to download the result, you would need to use Result API.

Route

/enriched/gstn/{flynn-version}/search-taxpayers-from-pan/{pan}

• active ‘flynn-version’: v3.0
• method: GET

URL Parameters

Name	Description	Type
flynn-version	version of the API for example, v3.0	string
pan	PAN of the taxpayer matches pattern: [A-Z]{5}[0-9]{4}[A-Z]{1}	string

Headers

All required headers to make an authenticated API call.

Tip

The only valid value for the header key accept is application/json.

Also, since no request body is sent, header key Content-type is optional.

Response

Status Code: 200

Successful response will an async task-id. Using this task-id you will be able to fetch the status of the request.

Sample Response Body

    {
      "status": "1",
      "data": {
        "task-id": "2a51e392-529c-4b5a-bfd8-ca14d510a68d"
      },
      "error": null,
      "info": null,
      "additionalInfo": null,
      "alert": null
    } 

Since this is a long-running task. Result of the task is downloaded once the process is completed. To check the process status of the task, call status api. To get the result of the task, call result api.

Result API Response

Download API response is unique for each API.

Result will be a map of GSTIN found to detail of search taxpayer API according to the latest version of GSTN. Visit GSTN documentation for detailed output.

Successful Response

{
  "data": {
    "status": "1",
    "data": [
      {
        "status": "1",
        "data": {
          "gstin": "33GSPTN0791G1Z5",
          "lgnm": "Vayana TN TaxPayer 1 Ltd",
          "stj": "ADYAR",
          "stjCd": "TN001",
          "ctj": "ALLAHABAD-I",
          "ctjCd": "0101",
          "rgdt": "01/04/2016",
          "ctb": "Proprietorship",
          "dty": "Regular",
          "nba": null,
          "sts": "Active",
          "cxdt": null,
          "lstupdt": "20/03/2017",
          "tradeNam": "Vayana TN TaxPayer 1 Ltd",
          "adadr": null,
          "pradr": null
        },
        "error": null,
        "info": null,
        "additionalInfo": {
          "key": {
            "GSTIN": "33GSPTN0791G1Z5"
          }
        },
        "alert": null
      }
    ],
    "error": null,
    "info": null,
    "additionalInfo": null,
    "alert": null
  }
}    

Note

The search results for PAN to GSTIN is based on an algorithm developed by Vayana and returns maximum possible GSTINs registered for the searched PAN. Since there are no direct APIs made available by GSTN, there could be a remote possibility of some GSTINs not picked up.