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

Retrieve Quarterly GST Filing Preference Information Through an API.

Access filing preference information for a specified GSTIN and financial year using the RPACPC Get Preference API. Integrate the returned quarterly preferences into GST-related applications, tax workflows, and business reporting systems.

Sample verification Dummy data
1 You send
Checking
2 You get back
✓
ACTIVEValid & registered
482 ms
QuarterQ1
PreferenceN
QuarterQ2
PreferenceM
QuarterQ3
PreferenceQ
QuarterQ4
PreferenceQ
API overview

Simplify Get Preference Verification.

RPACPC Get Preference API retrieves preference information for a GST registration number (GSTIN) for a specified financial year.

The response contains a list of quarters and their corresponding preference values. This information can be incorporated into GST-related applications and internal workflows where quarterly preference data is required.

Key Information Available

Access essential Get Preference details.

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

01
Quarter Information

Quarter identifier returned in the response, such as Q1 or Q2.

quarter
02
Preference Details

Preference value returned for the corresponding quarter.

preference
03
GST Registration Details

GST registration number supplied in the request.

gstin
04
Financial Year Details

Financial year supplied in the request.

fy
The API response sample contains four quarterly entries, each with a quarter and preference value.
How It Works

Simple API-based verification process.

Step 01

Provide the GSTIN

Specify the GST registration number for which preference information is required.

Step 02

Specify the Financial Year

Pass the relevant financial year using the fy parameter.

Step 03

Submit the API Request

Call the endpoint using the GETPREF action.

Step 04

Retrieve Preference Details

Process the returned quarter-wise preference values from the API response.

API Request

Step 1 Submit Get Preference API details.

Request parameters
Parameter Type Description
request_id String Unique identifier for the API request.
consent String Consent indicator for fetching information via the RPACPC API.
consent_text String Consent declaration authorizing the retrieval of information.
gstNumber String GST Identification Number to verify.
The GSTIN in this example is illustrative. Replace it with the GSTIN you are authorized to query. Authentication requirements should be followed according to the RPACPC integration documentation.
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 Get Preference 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 GST preference response details.
data.response Array List of quarterly GST preference records.
data.response[].quarter String Quarter associated with the preference, such as Q1, Q2, Q3 or Q4.
data.response[].preference String Preference value returned for the corresponding quarter.
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": {
    "response": [
      {
        "quarter": "Q1",
        "preference": "N"
      },
      {
        "quarter": "Q2",
        "preference": "M"
      },
      {
        "quarter": "Q3",
        "preference": "Q"
      },
      {
        "quarter": "Q4",
        "preference": "Q"
      }
    ]
  },
  "message": "Dummy data fetched successfully",
  "requestid": "dummy-request-id-12345",
  "sequenceId": "dummy-sequence-id-12345",
  "responseId": "dummy-response-id-12345"
}

This example follows the response structure supplied for the API. The preference values are reproduced as returned; their precise business meanings should be confirmed before mapping them to user-facing filing-frequency labels.

Use cases

Get Preference API across business workflows.

GST Workflow Automation

Retrieve quarter-wise preference information for use in GST-related operational workflows.

Tax and Compliance Applications

Incorporate preference data into applications that manage GST information and related business processes.

Accounting and ERP Integration

Connect preference retrieval with accounting, ERP, or tax-management systems that need to process GST-related information.

Business Reporting

Use the returned quarterly entries as input for internal reporting and data-processing workflows.

GST Data Aggregation

Combine preference information with other GST API responses within a broader business application.

FAQ

Frequently asked questions

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

Still have a question? Talk to an expert
What does the Get Preference API do?
It retrieves quarter-wise preference information for a specified GSTIN and financial year.
Which parameters are required?
The supplied request uses action, gstin, and fy. For this API, the action value is GETPREF.
What is the format of the financial year?
The example uses 2023-24. Confirm the accepted financial-year formats with the RPACPC API documentation.
What do the preference values N, M, and Q mean?
The sample confirms that these values are returned by the API, but it does not define their meanings. Confirm the official code mapping before interpreting them as specific filing frequencies.
Does the response contain data for all four quarters?
The supplied response example contains entries for Q1, Q2, Q3, and Q4. The actual response for a particular GSTIN and financial year may depend on the data returned by the underlying service.
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.