Skip to main content
POST
/
gst
/
compliance
/
tax-payer
/
gstrs
/
{gstr}
/
{year}
/
{month}
/
new-proceed
New Proceed to File
curl --request POST \
  --url https://api.sandbox.co.in/gst/compliance/tax-payer/gstrs/{gstr}/{year}/{month}/new-proceed \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "RAW_BODY": {
    "gstin": "<string>",
    "ret_period": "<string>"
  }
}'
{
  "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

Taxpayer access token

ā€‹
x-api-key
string
required

API key for identification

ā€‹
x-api-version
string
default:1.0.0

API version

Path Parameters

ā€‹
gstr
string
required

Return Type

ā€‹
year
string
required

Year for which Return is to be filled

ā€‹
month
string
required

Month for which Retrun is to be filled

Query Parameters

ā€‹
is_nil
string

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

Example:

"Y"

Body

application/json
ā€‹
RAW_BODY
object

Proceed to file GST Return

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
ā€‹
timestamp
number
Example:

1763446641000

ā€‹
transaction_id
string
Example:

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