We’re excited to launch our latest product to simplify your business processes. Know More →
GST RPACPC GST SuitePublic GST, e-Invoice & e-Way Bill

GST Search API – Verify GST Registration Details.

Verify a Goods and Services Tax Identification Number (GSTIN) through the RPACPC GST Search API. Retrieve the GSTIN’s state information, registration status, state code, and validity indicator to support business verification and GST-related workflows.

Sample verification Dummy data
1 You send
Checking
2 You get back
✓
ACTIVEValid & registered
482 ms
GSTIN 27ABCDE1234F1Z5
State Code 27
State Name Maharashtra
Status Active
Valid GSTIN Yes
API overview

Simplify GST Search Verification.

The RPACPC GST Search API enables applications to check the GST registration information available for a supplied GSTIN.

The API uses the HTTP GET method and returns a structured JSON response containing the GSTIN, state information, registration status, and a Boolean validity indicator.

Authentication is performed before calling this internal API. The authentication API and its requirements will be documented separately.

Key Information Available

Access essential GST Search details.

The API response may include the following information, depending on the response received:

01
GST Identification

GST Identification Number returned by the API.

gstin
02
State Information

State code and state name associated with the GSTIN.

stateCode
stateName
03
Registration Status

Registration status returned by the API, such as Active.

registrationStatus
04
GSTIN Validity

Boolean indicator showing whether the GSTIN is valid.

validGstin
How It Works

Simple API-based verification process.

Step 01

Authenticate with RPACPC

Complete the required authentication process using the RPACPC authentication API.

Step 02

Submit the GSTIN

Send a GET request with the GSTIN and required query parameters.

Step 03

Retrieve the Result

Receive the available GST registration information in JSON format.

Step 04

Integrate the Response

Use the returned state, status, and validity fields in your business verification or GST-related workflow.

API Request

Step 1 Submit GST Search API details.

Request parameters
Parameter Type Description
request_id String Unique identifier for the API request.
consent String Consent indicator for fetching information (Y/N).
consent_text String Consent declaration for fetching information via the RPACPC API.
gstNumber String GST identification number to verify.
The authorization header above is a placeholder illustration, not a confirmed RPACPC authentication contract. Replace it with the actual authentication headers or credentials required by your authentication API.
Sample request REQUEST
{
  "request_id": "11111111111",
  "consent": "Y",
  "consent_text": "I hereby declare my consent agreement for fetching my information via RPACPC API",
  "gstNumber": "27ABCDE1234F1Z5",
}
API response

Step 2Receive structured GST Search API information.

Key response fields
Parameter Type Description
status String Indicates the API response status, such as SUCCESS.
errdata Null/Object Error information returned by the API, if available.
data Object Contains GSTIN verification details.
data.gstin String GST Identification Number being verified.
data.stateCode String State code associated with the GSTIN.
data.stateName String Name of the state associated with the GSTIN.
data.status String GST registration status, such as Active.
data.validGstin Boolean Indicates whether the GSTIN is valid (true or false).
message String Message describing the API response.
requestid String Identifier associated with the API request.
sequenceId String Sequence identifier associated with the API transaction.
responseId String Unique identifier associated with the API response.
200 · Sample responseRESPONSE
{
  "status": "SUCCESS",
  "errdata": null,
  "data": {
  "gstin": "27ABCDE1234F1Z5",
  "stateCode": "27",
  "stateName": "Maharashtra",
  "status": "Active",
  "validGstin": true
  },
  "message": "Dummy data fetched successfully",
  "requestid": "dummy-request-id-12345",
  "sequenceId": "dummy-sequence-id-12345",
  "responseId": "dummy-response-id-12345"
}

The response is illustrative and uses synthetic data. Actual response values depend on the GSTIN submitted and the information returned by the configured service.

Use cases

GST Search API across business workflows.

Customer GST Verification

Check GSTIN information during customer onboarding and business verification workflows.

Vendor Onboarding

Retrieve GST registration status and associated state information when registering vendors or suppliers.

B2B Business Verification

Incorporate GSTIN checks into business due-diligence and partner verification processes.

Invoice and Billing Workflows

Use the returned GSTIN information as one input when validating business records in billing or invoicing systems.

Bulk Business Record Checks

Integrate the API into automated workflows that process multiple GSTINs individually through API requests.

FAQ

Frequently asked questions

Common questions about the GST Search API — what it returns, how fast it is, and how to integrate.

Still have a question? Talk to an expert
What does the GST Search API do?
It retrieves GSTIN-related information, including state code, state name, registration status, and a validity indicator.
Which HTTP method does the API use?
The supplied endpoint uses the HTTP GET method.
Which parameters are required?
The supplied request uses action and gstin as query parameters.
Does the API require authentication?
Yes. As specified for this integration, authentication is performed before calling the internal API. Refer to the RPACPC authentication documentation for the actual authentication procedure and required headers.
What does validGstin mean?
It is the Boolean validity indicator returned by the API. Its exact validation rules should be confirmed against the service's implementation.
Does the API return the business name?
The response schema provided for this API does not include a business or legal name field. Use an appropriate additional API if business-name retrieval is required.
Does status: Active guarantee full GST compliance?
No. Registration status alone does not establish filing compliance or other aspects of a taxpayer's compliance position.
Can this API be used in an automated business workflow?
Yes. Applications can call the endpoint after authentication and process its JSON response according to their business rules.
Blog

What Is the Fastest Identity Solution for a Rapidly Growing Startup?

Discover the fastest identity solution for startups to streamline customer verification, speed up onboarding, and support business growth.

Read More
What Is the Fastest Identity Solution for a Rapidly Growing Startup?

India's verification infrastructure is already here.

Empower your applications with India's Enterprise Verification Intelligence Platform for faster, more reliable verification.