---
title: "Search Taxpayer By Pan"
method: GET
path: "/v1/verification/gstin/gstin-by-pan"
tags: ["GST APIs"]
---

# Search Taxpayer By Pan

`GET /v1/verification/gstin/gstin-by-pan`

## Request

- Base URL: `https://api.deepvue.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.deepvue.ai/v1/verification/gstin/gstin-by-pan`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `authorize`
- TypeScript: <https://skmtc.dev/deepvue/apis/deepvue-tech-developers-guide/docs/v1/verification/gstin/gstin-by-pan/get.ts> (a function with typed inputs; its response is checked against the schema)

- The Search GSTIN API by PAN takes in the pan of a business entity and provides you with the information of all the business entities that are associated with that corresponding pan.    
- The Search GSTIN API responds with the information of a particular GST entity associated with the GSTIN. However, Search GSTIN by PAN provides you with the details of all the entities that are associated with the pan.

## Query parameters

- `pan_number` string, required

## Response `200`

Successful Response

- union
  - RESPONSESEARCHGSTINBYPANSUCCESSFUL
    - `data` GstinByPan[], required
      - `gstin` string, required
      - `status` string, required
      - `state_code` string, required
    - `code` integer, required
    - `timestamp` integer, required
    - `transaction_id` string, required
  - RESPONSEGSTININVALIDPAN
    - `code` integer, required
    - `timestamp` integer, required
    - `transaction_id` string, required
    - `data` SearchGstinInvalidPanVerificationData, required
      - `error_code` string
      - `message` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/deepvue/apis/deepvue-tech-developers-guide.md) - [All operations](https://skmtc.dev/deepvue/apis/deepvue-tech-developers-guide/llms.txt) - [OpenAPI document](https://skmtc.dev/deepvue/apis/deepvue-tech-developers-guide/revisions/c1b0558e7d77?raw)