Skip to main content

​
GST Public APIs

GST Public APIs give you access to GST registration and compliance data without requiring taxpayer credentials. Verify GSTINs, monitor day-wise GSTIN changes, track return filing status, find GSTINs by PAN and state code, and work with unregistered e-commerce applicants.

​
What you can do

GSTIN verification

Validate a GSTIN. Get business details: legal name, trade name, taxpayer type, registration status, and principal address.

GSTIN change tracking

Retrieve GSTIN changes reported for a state on a selected date, with pagination support.

Track GST return filing

Check whether a business has filed GST returns for a financial year, with optional filtering by return type.

Find GSTINs by PAN

Discover GSTINs linked to a PAN in a specific state using state code.

Unregistered applicant details

Retrieve GST registration details for an unregistered e-commerce applicant using an enrolment number.

Validate applicant contacts

Validate the registered email address, mobile number, or both for an unregistered applicant.

​
How it works

1

Authenticate with Sandbox

Generate a JWT access token using your API key and secret via the Authenticate API.
2

Verify a GSTIN

Call Search GSTIN to verify GSTIN and fetch taxpayer details and registration status.
3

Monitor GSTIN changes

Call Get day-wise changed GSTINs with a state code and date to retrieve reported GSTIN changes.
4

Track return filing

Call Track GST Returns with financial year and optional return type filter.
5

Find GSTIN by PAN

Call Search GSTIN by PAN with PAN and state code, then verify each GSTIN.
6

Work with unregistered applicants

Use Get unregistered applicant details and Validate unregistered applicants with an enrolment number.

​
API reference

​
Common use cases

Use GST Public APIs when you need to:
  • Verify GSTIN during vendor onboarding and validate status is Active and names match vendor details
  • Validate supplier GSTIN status before processing invoices for Active or Cancelled status
  • Track GST return filing history for supplier compliance monitoring across financial years
  • Find GSTINs when you only have PAN and state code, then verify the discovered GSTINs
  • Monitor GSTIN changes reported for a state to support compliance and onboarding workflows
  • Retrieve GST registration details for an unregistered e-commerce applicant
  • Validate an unregistered applicant’s registered email address or mobile number before further communication
  • Build dashboards that monitor GSTIN status changes and filing behavior over time

​
FAQ

GST Public APIs are Sandbox endpoints for public GST data. They let you verify GSTINs, monitor GSTIN changes, track return filing status, find GSTINs by PAN and state code, and work with unregistered applicants. No taxpayer credentials are required.
Yes. Search GSTIN verifies whether a GSTIN belongs to a GST-registered business. It returns business details and registration status. Use Search GSTIN for onboarding and compliance workflows.
No. These are public endpoints. You only need Sandbox authentication via Authenticate to generate a JWT access token. Pass the token in the Authorization header (no Bearer prefix).
Call Authenticate with your x-api-key and x-api-secret to generate a JWT access token. Then pass the token directly in the Authorization header when calling Search GSTIN. Sandbox tokens aren’t Bearer tokens.
Track GST Returns requires GSTIN in the request body and financial_year as a query parameter. Add the optional gstr query parameter to filter by return type. See Errors for troubleshooting.
Use Search GSTIN by PAN with PAN in the request body and state_code as a query parameter. This returns GSTINs for the PAN in that state. Validate each GSTIN using Search GSTIN.
Use Get day-wise changed GSTINs with a two-digit state_code and a date in DD-MM-YYYY format. Use the optional page field to retrieve subsequent pages.
Use Get unregistered applicant details with an enrolment_number to retrieve applicant details. Use Validate unregistered applicants with the enrolment number and at least one of mobile or email to validate registered contact details.
It’s an optional header that returns cached responses when available. This speeds up repeated requests. Set it to true if your workflow can tolerate cached data. See endpoint docs for Search GSTIN and Track GST Returns.