GSTIN

GET/v0/in/gstin

Validates a GSTIN (Goods and Services Tax Identification Number) — the 15-character identifier assigned to businesses registered under India's GST system. The format is: 2-digit state code + 10-character PAN + entity number + default character + check character (mod-36 algorithm). The state/UT code, PAN structure, and check character are all verified. Spaces and hyphens are stripped automatically.

Try it

Query Parameters

Parameter	Type	Required	Description
value	string	Yes	The 15-character GSTIN (e.g. `27AAPFU0939F1ZV`)

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/in/gstin?value=27AAPFU0939F1ZV"

Response Fields

Field	Type	Description
valid	boolean	Whether the GSTIN passed all validations
gstin	string	The normalized 15-character GSTIN
stateCode	string	2-digit Indian state/UT code
stateName	string	Name of the state or union territory
pan	string	10-character PAN (Permanent Account Number) embedded in the GSTIN
entityNumber	string	Entity number within the state for the same PAN
entityType	string	Entity type derived from PAN (Company, Individual, Firm, etc.)
checkChar	string	The mod-36 check character (last character)

Example Response

{
  "valid": true,
  "gstin": "27AAPFU0939F1ZV",
  "stateCode": "27",
  "stateName": "Maharashtra",
  "pan": "AAPFU0939F",
  "entityNumber": "1",
  "entityType": "Firm",
  "checkChar": "V"
}

Example Response — invalid

{
  "valid": false
}