Retrieve GSTIN-linked business details, registration status, HSN information, business addresses, return filing records, filing frequency and liability-paid details based on the options requested.
The RPACPC GST Verification API enables businesses to retrieve GST registration and related information using a GSTIN. The API supports optional data flags to request additional information, including HSN details, branch details, filing details, filing frequency and liability-paid details.
This API can support GST verification workflows for customer onboarding, vendor verification, KYB checks, compliance reviews and business due diligence.
The API response may include the following information, depending on the response received:
GSTIN, legal name, trade name, registration type, constitution and registration status.
Business nature, registration date, aggregate turnover slab and other available registration attributes.
Available goods or services classification codes and descriptions.
Permanent business address, business activities and additional addresses, where available.
Return filing records, financial year, return type, period, filing date, mode and status.
Quarterly filing preference and available financial-year and period-wise liability-paid profile information.
Provide the GST number along with the required request and consent fields.
Enable optional flags for HSN, branch, filing, filing frequency and liability-paid information.
RPACPC processes the request and returns the available GST-linked information.
Integrate the returned information into your onboarding, verification or compliance workflow.
| Parameter | Type | Description |
|---|---|---|
| request_id | String | Unique identifier for the API request. |
| consent | String | Consent indicator. The supplied example uses Y. |
| consent_text | String | Consent statement associated with the request. |
| gstNumber | String | GSTIN to be verified. |
| hsnDetails | Boolean | Set to true to request HSN details. |
| branchDetails | Boolean | Set to true to request branch and address details. |
| filingDetails | Boolean | Set to true to request return filing details. |
| filingFrequency | Boolean | Set to true to request filing frequency information. |
| liabilityPaidDetails | Boolean | Set to true to request liability-paid details. |
| contact | Boolean | Mentioned in the request example as a commented option; availability and response structure should be confirmed. |
{
"request_id": "1234567890",
"consent": "Y",
"consent_text": "I hereby declare my consent agreement for fetching my information via RPACPC API",
"gstNumber": "27ABCDE1234F1Z5",
"hsnDetails": true,
"branchDetails": true,
"filingDetails": true,
"filingFrequency": true,
"liabilityPaidDetails": true
}| Field | Description |
|---|---|
| basicDetails.gstin | GSTIN associated with the registered business. |
| basicDetails.Legal_Name | Legal name of the registered business. |
| basicDetails.tradeNam | Trade name of the registered business. |
| basicDetails.constitution | Constitution or legal structure of the registered business. |
| basicDetails.registrationType | Registration category or type. |
| basicDetails.registrationDate | Date on which the GST registration was issued. |
| basicDetails.registrationStatus | Current registration status as returned by the service. |
| basicDetails.aggreTurnOver | Aggregate turnover slab associated with the registration. |
| basicDetails.aggreTurnOverFY | Financial year associated with the aggregate turnover information. |
| basicDetails.businessNature | Business activities associated with the GST registration. |
| hsnDetails.services | Goods or services classification information available in the response. |
| hsnDetails.hsnCode | HSN or classification code associated with the goods or services. |
| hsnDetails.hsnDescription | Description of the goods or services associated with the HSN code. |
| branchDetails.permanentAdd | Permanent business address associated with the GST registration. |
| branchDetails.additionalAdd | Additional business addresses available in the response. |
| filingDetails.finYear | Financial year associated with the return filing record. |
| filingDetails.period | Return filing period. |
| filingDetails.returnType | Type of GST return filed. |
| filingDetails.filingDate | Date on which the return was filed. |
| filingDetails.status | Status of the return filing record. |
| filingFrequency.quarter | Quarter for which the filing preference is reported. |
| filingFrequency.preference | Current-year filing preference for the specified quarter. |
| filingFrequencyLastYear.quarter | Quarter for which the previous-year filing preference is reported. |
| filingFrequencyLastYear.preference | Previous-year filing frequency preference for the specified quarter. |
| liabilityPaidDetails.currFinYear | Current financial year liability-paid information. |
| liabilityPaidDetails.PrevFinYear | Previous financial year liability-paid information. |
| liabilityPaidDetails.currDetails | Available period-wise liability-paid details for the current financial year. |
| liabilityPaidDetails.prevDetails | Available period-wise liability-paid details for the previous financial year. |
{
"status": "SUCCESS",
"errdata": null,
"data": {
"basicDetails": {
"gstin": "27ABCDE1234F1Z5",
"Legal_Name": "SAMPLE ENTERPRISE PRIVATE LIMITED",
"tradeNam": "SAMPLE ENTERPRISE",
"constitution": "Private Limited Company",
"registrationType": "Regular",
"registrationDate": "14/11/2017",
"registrationStatus": "Active",
"aggreTurnOver": "Slab: Rs. 0 to 40 lakhs",
"businessNature": [
"Supplier of Services"
]
},
"hsnDetails": {
"services": [
{
"hsnCode": "00440452",
"hsnDescription": "INFORMATION TECHNOLOGY SOFTWARE SERVICE"
}
]
},
"branchDetails": {
"permanentAdd": {
"address": "Sample business address, Maharashtra, 400001",
"dealsIn": "Supplier of Services"
},
"additionalAdd": []
},
"filingDetails": {
"currentYear": {
"filingStatus": [
[
{
"finYear": "2026-2027",
"period": "June",
"mode": "ONLINE",
"filingDate": "01/07/2026",
"returnType": "GSTR1",
"status": "Filed"
}
]
],
"status": "No records Found"
}
},
"filingFrequency": [
{
"quarter": "Q1",
"preference": "Q"
}
],
"liabilityPaidDetails": {
"currFinYear": "2026",
"PrevFinYear": "2025",
"currDetails": [
{
"period": "Jun-26",
"profile": "Q",
"flag": "-"
}
]
}
},
"message": "Data fetch successfully!!!"
}The response example is abbreviated and uses illustrative business information. The source response includes additional fields and metadata, which may be exposed in the API response.
Verify GST registration information as part of business customer onboarding and KYB workflows.
Check GSTIN-linked business identity, registration status and available business details before vendor activation.
Use registration, business activity and available filing information as inputs to business verification and review processes.
Retrieve available return filing history and filing frequency information to support internal compliance review workflows.
Use returned HSN or service classification information to support business categorisation and related operational workflows.
Common questions about the GST Verification API — what it returns, how fast it is, and how to integrate.
Government ID Check API helps banks, FinTechs, and NBFCs streamline KYC with faster identity verification and reduced manual work.
Read More
Empower your applications with India's Enterprise Verification Intelligence Platform for faster, more reliable verification.