GST Public APIs
GST Public APIs give you access to GST registration and compliance data without requiring taxpayer credentials. Verify GSTINs, track return filing status by financial year, and find GSTINs by PAN and state code.What you can do
GSTIN verification
Validate a GSTIN. Get business details: legal name, trade name, taxpayer type, registration status, and principal address.
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.
Cache-friendly lookups
Accept cached responses with the x-accept-cache header for faster lookups.
How it works
Authenticate with Sandbox
Generate a JWT access token using your API key and secret via the Authenticate API.
Verify GSTIN
Call Search GSTIN to verify GSTIN and fetch taxpayer details and registration status.
Track return filing
Call Track GST Returns with financial year and optional return type filter.
Find GSTIN by PAN
Call Search GSTIN by PAN with PAN and state code, then verify each GSTIN.
API reference
| API | Purpose |
|---|---|
| Authenticate | Generate a JWT access token using x-api-key and x-api-secret |
| Search GSTIN | Verify GSTIN and fetch taxpayer details and registration status |
| Track GST Returns | Track return filing status by financial year with optional return type filter |
| Search GSTIN by PAN | Find GSTINs using PAN and state code, then verify each GSTIN |
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
- Build dashboards that monitor GSTIN status changes and filing behavior over time
FAQ
What are GST Public APIs?
What are GST Public APIs?
GST Public APIs are Sandbox endpoints for public GST data. They let you verify GSTINs, track return filing status, and find GSTINs by PAN and state code. No taxpayer credentials required. See Search GSTIN and Track GST Returns.
Is Search GSTIN a GSTIN verification API?
Is Search GSTIN a GSTIN verification API?
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.
Do I need GST portal credentials for these APIs?
Do I need GST portal credentials for these APIs?
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).
How does authentication work for GST Public APIs?
How does authentication work for GST Public APIs?
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 endpoints like Search GSTIN. Sandbox tokens aren’t Bearer tokens.
What inputs are required for Track GST Returns?
What inputs are required for Track GST Returns?
Track GST Returns requires GSTIN in the request body and financial_year as a query parameter. Add an optional gstr query parameter to filter by return type. See Track GST Returns and Errors for troubleshooting.
How do I find GSTIN when I only have PAN?
How do I find GSTIN when I only have PAN?
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.
What is x-accept-cache and when should I use it?
What is x-accept-cache and when should I use it?
It’s an optional header that returns cached responses when available. This speeds up lookups. Set it to true if your workflow can tolerate cached data. See endpoint docs for Search GSTIN and Track GST Returns.