> ## Documentation Index
> Fetch the complete documentation index at: https://developer.sandbox.co.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Verify GSTINs, monitor day-wise GSTIN changes, track GST return filing status, find GSTINs by PAN and state code, and validate unregistered applicants using Sandbox GST Public APIs.

# 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

<CardGroup cols={2}>
  <Card title="GSTIN verification" icon="badge-check">
    Validate a GSTIN. Get business details: legal name, trade name, taxpayer type, registration status, and principal address.
  </Card>

  <Card title="GSTIN change tracking" icon="arrows-rotate">
    Retrieve GSTIN changes reported for a state on a selected date, with pagination support.
  </Card>

  <Card title="Track GST return filing" icon="file-circle-check">
    Check whether a business has filed GST returns for a financial year, with optional filtering by return type.
  </Card>

  <Card title="Find GSTINs by PAN" icon="id-card">
    Discover GSTINs linked to a PAN in a specific state using state code.
  </Card>

  <Card title="Unregistered applicant details" icon="building">
    Retrieve GST registration details for an unregistered e-commerce applicant using an enrolment number.
  </Card>

  <Card title="Validate applicant contacts" icon="envelope">
    Validate the registered email address, mobile number, or both for an unregistered applicant.
  </Card>
</CardGroup>

## How it works

<Steps>
  <Step title="Authenticate with Sandbox">
    Generate a JWT access token using your API key and secret via the [Authenticate](/api-reference/authenticate) API.
  </Step>

  <Step title="Verify a GSTIN">
    Call [Search GSTIN](/api-reference/gst/compliance/endpoints/public/search_gstin) to verify GSTIN and fetch taxpayer details and registration status.
  </Step>

  <Step title="Monitor GSTIN changes">
    Call [Get day-wise changed GSTINs](/api-reference/gst/compliance/endpoints/public/get-day-wise-changed-gstins) with a state code and date to retrieve reported GSTIN changes.
  </Step>

  <Step title="Track return filing">
    Call [Track GST Returns](/api-reference/gst/compliance/endpoints/public/track_gstrs) with financial year and optional return type filter.
  </Step>

  <Step title="Find GSTIN by PAN">
    Call [Search GSTIN by PAN](/api-reference/gst/compliance/endpoints/public/search_pan_state_code) with PAN and state code, then verify each GSTIN.
  </Step>

  <Step title="Work with unregistered applicants">
    Use [Get unregistered applicant details](/api-reference/gst/compliance/endpoints/public/get-unregistered-applicant-details) and [Validate unregistered applicants](/api-reference/gst/compliance/endpoints/public/unregistered-applicants-validation) with an enrolment number.
  </Step>
</Steps>

## API reference

| API | Purpose |
| :- | :- |
| [Authenticate](/api-reference/authenticate) | Generate a JWT access token using `x-api-key` and `x-api-secret` |
| [Search GSTIN](/api-reference/gst/compliance/endpoints/public/search_gstin) | Verify GSTIN and fetch taxpayer details and registration status |
| [Get day-wise changed GSTINs](/api-reference/gst/compliance/endpoints/public/get-day-wise-changed-gstins) | Retrieve GSTIN changes for a state and date |
| [Track GST Returns](/api-reference/gst/compliance/endpoints/public/track_gstrs) | Track return filing status by financial year with optional return type filter |
| [Search GSTIN by PAN](/api-reference/gst/compliance/endpoints/public/search_pan_state_code) | Find GSTINs using PAN and state code, then verify each GSTIN |
| [Get unregistered applicant details](/api-reference/gst/compliance/endpoints/public/get-unregistered-applicant-details) | Retrieve unregistered applicant details using an enrolment number |
| [Validate unregistered applicants](/api-reference/gst/compliance/endpoints/public/unregistered-applicants-validation) | Validate an applicant's registered email address, mobile number, or both |

## 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

<AccordionGroup>
  <Accordion title="What are GST Public APIs?">
    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.
  </Accordion>

  <Accordion title="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](/api-reference/gst/compliance/endpoints/public/search_gstin) for onboarding and compliance workflows.
  </Accordion>

  <Accordion title="Do I need GST portal credentials for these APIs?">
    No. These are public endpoints. You only need Sandbox authentication via [Authenticate](/api-reference/authenticate) to generate a JWT access token. Pass the token in the Authorization header (no Bearer prefix).
  </Accordion>

  <Accordion title="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 Search GSTIN. Sandbox tokens aren't Bearer tokens.
  </Accordion>

  <Accordion title="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 the optional `gstr` query parameter to filter by return type. See [Errors](/guides/developer-resources/errors) for troubleshooting.
  </Accordion>

  <Accordion title="How do I find GSTIN when I only have PAN?">
    Use [Search GSTIN by PAN](/api-reference/gst/compliance/endpoints/public/search_pan_state_code) 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](/api-reference/gst/compliance/endpoints/public/search_gstin).
  </Accordion>

  <Accordion title="How do I retrieve day-wise GSTIN changes?">
    Use [Get day-wise changed GSTINs](/api-reference/gst/compliance/endpoints/public/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.
  </Accordion>

  <Accordion title="How do I work with unregistered applicants?">
    Use [Get unregistered applicant details](/api-reference/gst/compliance/endpoints/public/get-unregistered-applicant-details) with an `enrolment_number` to retrieve applicant details. Use [Validate unregistered applicants](/api-reference/gst/compliance/endpoints/public/unregistered-applicants-validation) with the enrolment number and at least one of `mobile` or `email` to validate registered contact details.
  </Accordion>

  <Accordion title="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 repeated requests. Set it to true if your workflow can tolerate cached data. See endpoint docs for [Search GSTIN](/api-reference/gst/compliance/endpoints/public/search_gstin) and [Track GST Returns](/api-reference/gst/compliance/endpoints/public/track_gstrs).
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.