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.
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.
The API response may include the following information, depending on the response received:
Quarter identifier returned in the response, such as Q1 or Q2.
Preference value returned for the corresponding quarter.
GST registration number supplied in the request.
Financial year supplied in the request.
Specify the GST registration number for which preference information is required.
Pass the relevant financial year using the fy parameter.
Call the endpoint using the GETPREF action.
Process the returned quarter-wise preference values from the API response.
| 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. |
{
"request_id": "11111111111",
"consent": "Y",
"consent_text": "I hereby declare my consent agreement for fetching my information via RPACPC API",
"gstNumber": "27ABCDE1234F1Z5",
}
| 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. |
{
"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.
Retrieve quarter-wise preference information for use in GST-related operational workflows.
Incorporate preference data into applications that manage GST information and related business processes.
Connect preference retrieval with accounting, ERP, or tax-management systems that need to process GST-related information.
Use the returned quarterly entries as input for internal reporting and data-processing workflows.
Combine preference information with other GST API responses within a broader business application.
Common questions about the Get Preference 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.