Verification API

GST Verification API

Verify a GSTIN - format, official check-digit and your GST data.

GET /v1/verify/gstin/{gstin}
Get API key Pricing Talk to sales
3 credits per successful call · full rate card

Overview

The GST Verification API validates a GSTIN three ways: the 15-character format, the official mod-36 check-digit, and a lookup in your GST dataset for the real registration status. Use it to validate GST numbers on invoices and during vendor onboarding.

  • Format + official check-digit validation
  • Real status when found in your data
  • State code and PAN extracted
  • Returns valid true/false
  • Single fast call

Auth, limits & freshness

  • Auth: Send Authorization: Bearer <api_key> (pk_test_… or pk_live_…).
  • Rate / credits: Fair-use and plan limits apply; see your API console for remaining credits.
  • Freshness: Sourced from Infyner’s MCA-aligned company master; refresh cadence varies by dataset.
  • Errors: Errors return a JSON envelope with success=false and an error code (e.g. NOT_FOUND, UNAUTHORIZED).

How it works

  1. Generate an API key in your developer console (test keys are free).
  2. Call the endpoint with your Bearer key.
  3. Read the JSON response (standard envelope with credits info).
  4. Map the fields into your product or workflow.

Request & response

Requestcurl "https://www.infyner.com/v1/verify/gstin/27AAACT2727Q1ZW" \ -H "Authorization: Bearer pk_test_xxxxxxxx"
Response (sample){ "success": true, "data": { "gstin": "27AAACT2727Q1ZW", "valid": true, "found": true, "gst_status": "Active", "state": "Maharashtra", "format_valid": true, "checksum_valid": true } }

Try it live with a free test key from your sandbox.

Where it's used

  • Validate GSTINs on invoices
  • Vendor / supplier onboarding
  • Bulk GST data cleaning
  • Fraud prevention

Frequently asked questions

How is a GSTIN verified?

We validate the format and the official mod-36 check digit, and look the GSTIN up in our GST data to return its real status when found.

Is this a live GSTN status call?

Status comes from our GST dataset. For a real-time government GSTN status, an official upstream can be added to the same endpoint.

Related APIs
Company Search API
Search Indian companies by name or CIN and get the top matching companies with their CIN.
Company CIN Lookup API
Get a company's core details from its CIN in real time - name, status, incorporation, registered office and ROC.
CIN to PAN
Get a company's PAN from its CIN using Infyner's company master — charged only when PAN is available.

Start building in minutes

Generate a free test key, call the sandbox, and go live when you're ready.

Get API access