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

Retrieve GST Return Filing Records Through an API.

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.

Sample verification Dummy data
1 You send
Checking
2 You get back
✓
ACTIVEValid & registered
482 ms
GSTIN 06AAAFE2692XXXX
Legal Name SAMPLE TRADERS
Trade Name SAMPLE TRADERS
Registration Type Regular
Constitution Partnership
Registration Date 01/07/2017
Registration Status ✓ Active
Aggregate Turnover Rs. 1.5 Cr. to 5 Cr.
Business Nature Wholesale, Retail
E-Invoice Status Yes
Aadhaar Verified No
Jurisdiction Maharashtra, Mumbai
API overview

Simplify GST Return Status.

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.

Key information available

Access essential GST Return Status details.

Depending on the response, the API may provide:

01
Filing Records

Collection of GST return filing records returned by the API.

EFiledlist
02
Filing Validity

Validity indicator returned for a filing record.

valid
03
Mode of Filing

Filing method recorded for the GST return.

mof
04
Filing Date

Date on which the GST return was filed.

dof
05
Return Period

Return period associated with the filing record.

ret_prd
06
Return Type

Type of GST return, such as GSTR1 or GSTR3B.

rtntype
07
Acknowledgement Reference

Acknowledgement Reference Number associated with the filing record.

arn
08
Filing Status

GST return filing status, such as Filed.

status
The API returns the fields shown in the supplied sample. Availability and interpretation of individual fields should be confirmed against the API's complete response specification.
How it works

Simple two-step verification process.

Step 01

Provide the GSTIN

Specify the GST registration number for which return filing records are required.

Step 02

Specify the Financial Year

Pass the required financial year using the fy parameter.

Step 03

Submit the GST Returns Request

Call the Returns endpoint with the action value RETTRACK.

Step 04

Retrieve Filing Records

Process the returned EFiledlist array to access available GST return filing records.

Step 05

Integrate the Results

Use the available return details in your business application, reporting process, or GST monitoring workflow.

API Request

Step 1 Submit GST Return Status details.

Request parameters
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.

 

Replace YOUR_GSTIN with the GSTIN you are authorized to query. Follow the authentication requirements specified in your RPACPC integration documentation.
Sample request REQUEST
{
  "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
}
API response

Step 2Receive structured GST Return Status information.

Key response fields
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.
200 · Sample responseRESPONSE
{
  "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.

Use cases

GST Return Status across business workflows.

GST Return Filing Monitoring

Retrieve available filing records to support internal monitoring of GST return submissions.

Business and Vendor Assessment

Incorporate return filing information into business assessment workflows where GST return records are relevant.

Accounting and ERP Integration

Connect GST return records with accounting or ERP systems for internal processing and reporting.

Tax Compliance Workflows

Use returned filing dates, return types, and statuses as inputs to GST-related operational workflows.

Automated Reporting

Process the returned filing records to prepare internal reports based on the information available through the API.

FAQ

Frequently asked questions

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

Still have a question? Talk to an expert
What does the GST Return Status API do?
It retrieves GST return filing records for a specified GSTIN and financial year, based on the supplied request structure.
Which parameters are required?
The sample request uses action, gstin, and fy. The action value for this API is RETTRACK.
What is the EFiledlist field?
It is an array containing the return filing records returned by the API.
Which return types can appear in the response?
The supplied example includes GSTR1 and GSTR3B. The complete list of supported return types should be confirmed against the API documentation.
What does ARN mean?
ARN stands for Acknowledgement Reference Number. The response includes an arn field for each record shown in the example.
Does this API confirm that a taxpayer has filed every required return?
The API returns the filing records available in its response. The sample alone does not establish whether all required returns are included or whether missing records should be interpreted as non-filing.
Does the API provide return filing dates?
Yes. The sample includes a dof field representing the filing date for each returned record.
How can I integrate this API?
Contact the RPACPC team for authentication details, access requirements, and integration guidance.
Blog

Government ID Check API: How Does It Help Banks, FinTechs, and NBFCs Streamline KYC?

Government ID Check API helps banks, FinTechs, and NBFCs streamline KYC with faster identity verification and reduced manual work.

Read More
Government ID Check API: How Does It Help Banks, FinTechs, and NBFCs Streamline KYC?

India's verification infrastructure is already here.

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