Proceed to file GSTR

GSTR-1 is a sales return that is required to be filed by every GST-registered person or entity. Sandbox API for freezing the GSTR1 invoices data of authenticated taxpayers just before filing.

Overview

  • This is the second step in filing GSTR-1
  • Begin the process of filing for taxpayer (gstin) for a particular return period ret_period.

📘

Upload again

If your return has changed use the Reset GSTR-1 API

Endpoint

HTTP MethodResource
post/gsp/tax-payer/{gstin}/gstrs/{year}/{month}/proceed

API Endpoint  Contact Us  Free Trial

Request Body

ParamTypeDescriptionExample
gstinstring15-character alpha-numeric unique identifier assigned to business entities registering under the GST regime22AAAAA0000A1Z5
ret_periodstringReturn Period: MMYYYY052018

Path Parameters

ParamTypeDescriptionExample
gstinstring15-character alpha-numeric unique identifier assigned to business entities registering under the GST regime.22AAAAA0000A1Z5
gstrstringType of GST Returngstr-1
yearstringYear for which Amended Advance Tax needs to be fetched.2020
monthstringMonth for which Amended Advance Tax needs to be fetched.01

Query Parameter

ParamTypeDescriptionExample
is_nilstringFor proceeding to file nil report Possible value : Y or NY

CURL would look something like this

curl --request POST \
		 --url 'https://api.sandbox.co.in/gsp/tax-payer/:gstin/gstrs/gstr-1/:year/:month/proceed?is_nil=Y' \
     --header 'Authorization: xxxxxxxxxx' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: xxxxxxxxxx' \
     --header 'x-api-version: 1.0' \
     --data '
{
     "gstin": "08AUGGC1893FDD5",
     "ret_period": "052018"
}
'

❗️

Test Environment Not Available


Response

ParamTypeDescriptionExample
reference_idstringReference idLAPN24235325555
isSyncstringSynchronous PTF flagY

📘

You can always reset the data by using the Reset GSTR-1 API.

Response Caching

Response caching is not available for this API. Learn more about our response caching mechanism here

Wallet Charges

Since Proceed to file GSTR is not a Paid API, no wallet charge will take place.

Versioning

This API is currently in major version 1.0. Refer to our versioning policies here


What’s Next