curatedapi

GSTIN check (India)

Check the state code, structure and check character of an Indian GSTIN and read the PAN inside it.

The 15-character GSTIN. Spaces, dots, hyphens and slashes are ignored, and lower-case letters are read as upper case. At most 64 characters.

Examples

Result: A Maharashtra GSTIN

Valid
Whether the GSTIN passes every check.
yes
Normalized
The number as it was checked: separators removed, letters in upper case.
27AAPFU0939F1ZV
Message
The result in a sentence, naming the rule that failed.
A well-formed GSTIN registered in Maharashtra.
State code
The first two digits.
27
State
The state or territory of the code.
Maharashtra
Kind
A regular taxpayer's GSTIN (with a PAN inside) or another kind of registration.
regular taxpayer
Pan
Characters 3 to 12, for a regular taxpayer.
AAPFU0939F
Pan holder
The kind of holder the PAN's fourth character stands for.
Firm or limited liability partnership
Entity number
Character 13: which of the holder's registrations in the state this is.
1
Check character
The last character.
V
Expected check character
The check character the first 14 characters give.
V

Calculator check/india-gstin@1.

How it is calculated

value each character 0 to 35 (digits, then A to Z); from the right, double every second value and add its base-36 digits; the check character makes the total a multiple of 36

Checks a 15-character Goods and Services Tax Identification Number: a two-digit state code, the holder's ten-character PAN, an entity number, a default letter and a check character. The check character is worked out over the first 14 characters with the Luhn rule in base 36.

  • The number is checked by arithmetic alone. Nothing is looked up, so a valid result means the number is well formed, not that the account, company or security exists.
  • Whether a GSTIN is registered and active is on the GST portal, which is not consulted.

References

Results follow each calculator's documented rules and the sources listed. They are not financial, tax or legal advice. Check that the rules fit your case before you rely on a result. See the terms.

Use it from your code

POST /v1/calc/check/india-gstinVersion 1
curl https://api.curatedapi.com/v1/calc/check/india-gstin \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "27AAPFU0939F1ZV"
  }'
The same call in Python
import os

import requests

payload = {
    "number": "27AAPFU0939F1ZV",
}
response = requests.post(
    "https://api.curatedapi.com/v1/calc/check/india-gstin",
    headers={"Authorization": f"Bearer {os.environ['CURATEDAPI_KEY']}"},
    json=payload,
    timeout=10,
)
print(response.json()["result"])
The same call in JavaScript
const payload = {
    "number": "27AAPFU0939F1ZV",
};
const response = await fetch("https://api.curatedapi.com/v1/calc/check/india-gstin", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CURATEDAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify(payload),
});
console.log((await response.json()).result);

MCP tool calc_check_india_gstin at https://mcp.curatedapi.com. Inputs, outputs and errors in the API reference.

Put it on your website

<div data-curatedapi-widget="check/india-gstin" data-key="capi_public_…"></div>
<script src="https://widgets.curatedapi.com/v1/widget.js" async></script>

Use a public key registered for your site. Calculations are billed like API calls. How widgets work.

Related calculators

Add this calculator to your website

Paste two lines into your page and your visitors get this calculator. Each use counts as one call on your plan, the same as the API.

Free for up to 1,000 uses a month. 50,000 uses a month cost $9.00 on the Starter plan.