gst-validator

This package supports both ESM and CommonJS. Use import or require() depending on your project.

Validate and parse Indian GSTIN numbers - real checksum verification, state-code lookup, and the embedded PAN, all offline.

npm install gst-validator

import { isValidGstin, parseGstin } from 'gst-validator';

isValidGstin('27AAAPL1234C1ZE'); // true
isValidGstin('not-a-gstin');     // false

parseGstin('27AAAPL1234C1ZE');
// {
//   valid: true,
//   gstin: '27AAAPL1234C1ZE',
//   stateCode: '27',
//   stateName: 'Maharashtra',
//   pan: 'AAAPL1234C',
//   panEntityType: 'Individual',
//   registrationNumber: '1',
//   checkDigit: 'E',
// }

parseGstin('not-a-gstin'); // { valid: false }

A GSTIN is 15 characters: SSPPPPPPPPPPPCZC

This library checks, all offline:

• Format: matches the 15-character structure above
• State code: must be a real, currently-assigned GST state/UT code (not just any two digits)
• Checksum: recomputes the mod-36 check digit and confirms it matches - this catches typos that a regex alone would miss
• Embedded PAN: delegates to pan-card-validator to confirm the embedded PAN has a valid structure and holder-category code

Like PAN validation, this confirms a GSTIN is well-formed and internally consistent - it cannot confirm the GSTIN is actually registered. That requires the GST Network's own verification API.

MIT

Validation checks structure, checksum, and embedded PAN format. It does not confirm registration status or taxpayer ownership.