Access GST return filing records for a specified GSTIN and financial year using the RPACPC GST Return Status API. Retrieve available return types, return periods, filing dates, acknowledgement reference numbers, and status information to support GST-related workflows and business reporting.
The RPACPC GST Return Status API retrieves a list of GST return filing records for a specified GST registration number and financial year.
The response contains an EFiledlist array. Each entry can include the return type, return period, filing date, mode of filing, acknowledgement reference number (ARN), validity indicator, and return status.
This information can be integrated into accounting systems, ERP platforms, tax management applications, and internal GST monitoring workflows.
Depending on the response, the API may provide:
Collection of GST return filing records returned by the API.
Validity indicator returned for a filing record.
Filing method recorded for the GST return.
Date on which the GST return was filed.
Return period associated with the filing record.
Type of GST return, such as GSTR1 or GSTR3B.
Acknowledgement Reference Number associated with the filing record.
GST return filing status, such as Filed.
Specify the GST registration number for which return filing records are required.
Pass the required financial year using the fy parameter.
Call the Returns endpoint with the action value RETTRACK.
Process the returned EFiledlist array to access available GST return filing records.
Use the available return details in your business application, reporting process, or GST monitoring workflow.
| Parameter | Type | Required | Description |
|---|---|---|---|
| action | String | Yes | Use RETTRACK to request return tracking information. |
| gstin | String | Yes | GST registration number to query. |
| fy | String | Yes | Financial year, such as 2023-24. |
{
"request_id": "211026151603",
"consent": "Y",
"consent_text": "I hereby declare my consent agreement for fetching my information via RPACPC API",
"gstNumber": "06AAAFE2692XXXX",
"hsnDetails": false,
"branchDetails": false,
"filingDetails": true,
"filingFrequency": false,
"liabilityPaidDetails": false
}
| Field | Description |
|---|---|
| status | Overall API response status. |
| data.basicDetails.gstin | GST registration number. |
| data.basicDetails.Legal_Name | Legal name of the registered business. |
| data.basicDetails.tradeNam | Trade name of the business. |
| data.basicDetails.registrationStatus | Current GST registration status. |
| data.basicDetails.registrationType | GST registration type. |
| data.basicDetails.constitution | Constitution of the business. |
| data.basicDetails.registrationDate | Date of GST registration. |
| data.basicDetails.jurisdiction | State and district jurisdiction details. |
| data.basicDetails.aggreTurnOver | Aggregate turnover range. |
| data.basicDetails.businessNature | Business activities associated with the registration. |
| data.filingDetails.currentYear.filingStatus | Current-year GST return filing records, including financial year, period, filing date, return type, ARN, mode, and status. |
| data.filingDetails.previousYear.filingStatus | Previous-year GST return filing records, including financial year, period, filing date, return type, ARN, mode, and status. |
| message | Message returned by the API. |
| requestid | Identifier associated with the API request. |
| sequenceId | Sequence identifier returned by the API. |
| responseId | Identifier associated with the API response. |
{
"status": "SUCCESS",
"errdata": null,
"data": {
"basicDetails": {
"ntcrbs": "TRD:TWD",
"aadharVerified": "No",
"Legal_Name": "SAMPLE TRADERS",
"gstin": "06AAAFE2692XXXX",
"Ekyc_Flag": "No",
"compositionRate": "NA",
"constitution": "Partnership",
"tradeNam": "SAMPLE TRADERS",
"ctj": "State - CBIC, Zone - MUMBAI, Commissionerate - MUMBAI",
"percentTaxInCash": "NA",
"mandatedeInvoice": "No",
"aggreTurnOverFY": "2025-26",
"jurisdiction": "State - Maharashtra, District - Mumbai",
"registrationType": "Regular",
"aggreTurnOver": "Slab: Rs. 1.5 Cr. to 5 Cr.",
"cancelationDate": "",
"businessNature": [
"Wholesale Business",
"Retail Business"
],
"registrationDate": "01/07/2017",
"registrationStatus": "Active",
"percentTaxInCashFY": "",
"einvoiceStatus": "Y",
"memberDetails": [
"RAJESH SHARMA",
"AMIT SHARMA"
]
},
"filingDetails": {
"currentYear": {
"filingStatus": [
[
{
"finYear": "2026-2027",
"period": "September",
"mode": "ONLINE",
"filingDate": "10/10/2026",
"returnType": "GSTR1",
"arn": "DUMMY-ARN-001",
"status": "Filed"
},
{
"finYear": "2026-2027",
"period": "August",
"mode": "ONLINE",
"filingDate": "08/09/2026",
"returnType": "GSTR1",
"arn": "DUMMY-ARN-002",
"status": "Filed"
},
{
"finYear": "2026-2027",
"period": "September",
"mode": "ONLINE",
"filingDate": "20/10/2026",
"returnType": "GSTR3B",
"arn": "DUMMY-ARN-003",
"status": "Filed"
},
{
"finYear": "2026-2027",
"period": "August",
"mode": "ONLINE",
"filingDate": "19/09/2026",
"returnType": "GSTR3B",
"arn": "DUMMY-ARN-004",
"status": "Filed"
}
]
],
"status": "Records Found"
},
"previousYear": {
"filingStatus": [
[
{
"finYear": "2025-2026",
"period": "March",
"mode": "ONLINE",
"filingDate": "10/04/2026",
"returnType": "GSTR1",
"arn": "DUMMY-ARN-005",
"status": "Filed"
},
{
"finYear": "2025-2026",
"period": "February",
"mode": "ONLINE",
"filingDate": "07/03/2026",
"returnType": "GSTR1",
"arn": "DUMMY-ARN-006",
"status": "Filed"
},
{
"finYear": "2025-2026",
"period": "March",
"mode": "ONLINE",
"filingDate": "21/04/2026",
"returnType": "GSTR3B",
"arn": "DUMMY-ARN-007",
"status": "Filed"
},
{
"finYear": "2025-2026",
"period": "February",
"mode": "ONLINE",
"filingDate": "19/03/2026",
"returnType": "GSTR3B",
"arn": "DUMMY-ARN-008",
"status": "Filed"
}
]
],
"status": "Records Found"
}
}
},
"message": "Dummy data fetched successfully",
"requestid": "dummy-request-id-12345",
"sequenceId": "dummy-sequence-id-12345",
"responseId": "dummy-response-id-12345"
}
The response above is illustrative. The GSTIN and ARN values from the supplied example have not been reused. Confirm the accepted ARN format and field definitions against the API documentation.
Retrieve available filing records to support internal monitoring of GST return submissions.
Incorporate return filing information into business assessment workflows where GST return records are relevant.
Connect GST return records with accounting or ERP systems for internal processing and reporting.
Use returned filing dates, return types, and statuses as inputs to GST-related operational workflows.
Process the returned filing records to prepare internal reports based on the information available through the API.
Common questions about the GST Return Status API — what it returns, how fast it is, and how to integrate.
Discover the fastest identity solution for startups to streamline customer verification, speed up onboarding, and support business growth.
Read More
Empower your applications with India's Enterprise Verification Intelligence Platform for faster, more reliable verification.