New Proceed to File

Proceed to file generates the summary and marks the return ready for filing. Post this Summary can be fetched and EVC OTP can be generated for filing.

POST /gst/compliance/tax-payer/gstrs/{gstr}/{year}/{month}/new-proceed

New Proceed to File

cURL

curl --request POST \
  --url https://api.sandbox.co.in/gst/compliance/tax-payer/gstrs/{gstr}/{year}/{month}/new-proceed \
  --header 'Authorization: <authorization>' \
  --header 'x-api-key: <x-api-key>'

200

200 Success

{ "code": 200, "data": { "data": { "reference_id": "897c98eb-7877-4252-934d-46cb3a86c51a" }, "status_cd": "1" }, "timestamp": 1763446641000, "transaction_id": "557c0450-7ca9-45f2-ba07-b8d104cbc8b2" }

Headers

Authorization · string · required

GST taxpayer access token. For token-generation steps, refer to the Generate Taxpayer Session recipe, then pass the token in the Authorization header.

x-api-key · string · required

API key for identification

x-api-version · string · default: 1.0.0

API version

Path Parameters

gstr · string · required

Example:

"{{gst_return}}"

year · string · required

Year e.g. 2020

Example:

"{{year}}"

month · string · required

Month e.g. 01

Example:

"{{month}}"

Query Parameters

is_nil · string

For proceeding to file nil report Possible values: Y or N

Example:

"Y"

Response

200 - application/json

200 Success / RET192409 GSTR-3B not filed / AUTH154 Invalid return type / RET00009 Return Form already filed

code · number

Example:

200

data · object

Show child attributes

timestamp · number

Example:

1763446641000

transaction_id · string

Example:

"557c0450-7ca9-45f2-ba07-b8d104cbc8b2"