Overview

This is the first step in filing GSTR-1.
Upload GSTR-1 RAW_BODY to GSTN System for the authenticated taxpayer (gstin) for a particular year and month.

Endpoint

HTTP Method	Resource
`Post`	https://api.sandbox.co.in/gsp/tax-payer/{gstin}/gstrs/gstr-1/{year}/{month}

Request

Follow the below guidelines to pass GSTIN, year & month for getting amended business-to-business(B2BA) invoice details.

Path Parameters

Param	Type	Description	Example
gstin	`string`	15-character alpha-numeric unique identifier assigned to business entities registering under the GST regime	22AAAAA0000A1Z5
year	`string`	Year for which Advance Tax needs to be fetched.	2020
month	`string`	Month for which Advance Tax needs to be fetched.	01

Request Body

RAW BODY

Param	Type	Description	Example
gstin	`string`	GSTIN of the Tax Payer	22AAAAA0000A1Z5
fp	`string`	Return period	032020
gt	`num`	Gross Turnover in the preceding Financial Year	1000.00
cur_gt	`num`	Gross Turnover for the period	1000.00
at	`object`	GSTR-1 AT
ata	`object`	GSTR-1 ATA
b2b	`object`	GSTR-1 B2B
b2ba	`object`	GSTR-1 B2BA
b2cl	`object`	GSTR-1 B2CL
b2cla	`object`	GSTR-1 B2CLA
b2cs	`object`	GSTR-1 B2CS
b2csa	`object`	GSTR-1 B2CSA
cdnr	`object`	GSTR-1 CDNR
cdnra	`object`	GSTR-1 CDNRA
cdnur	`object`	GSTR-1 CDNUR
cdnura	`object`	GSTR-1 CDNURA
doc_issue	`object`	GSTR-1 Document Issued
exp	`object`	GSTR-1 EXP
expa	`object`	GSTR-1 EXPA
hsn	`object`	GSTR-1 HSN Summary
nil	`object`	GSTR-1 NIL Supplies
txpd	`object`
txpda	`object`

The CURL would look like this

curl --request POST \
     --url https://api.sandbox.co.in/gsp/tax-payer/%2022AAAAA0000A1Z5/gstrs/gstr-1/2020/01 \
     --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": "27AHQPA7588L1ZJ",
     "fp": "122016",
     "gt": 3782969.01,
     "cur_gt": 3782969.01,
     "b2ba": [],
     "cdnur": [],
     "cdnr": [],
     "expa": [],
     "b2cs": [],
     "txpd": [],
     "ata": [],
     "nil": {
          "inv": [
               {
                    "expt_amt": 0,
                    "nil_amt": 0,
                    "ngsup_amt": 0,
                    "sply_ty": "INTRB2B"
               },
               {
                    "expt_amt": 0,
                    "nil_amt": 0,
                    "ngsup_amt": 0,
                    "sply_ty": "INTRB2C"
               },
               {
                    "expt_amt": 0,
                    "nil_amt": 0,
                    "ngsup_amt": 0,
                    "sply_ty": "INTRAB2B"
               },
               {
                    "expt_amt": 0,
                    "nil_amt": 0,
                    "ngsup_amt": 0,
                    "sply_ty": "INTRAB2C"
               }
          ]
     },
     "b2b": [],
     "cdnura": [],
     "at": [],
     "b2cl": [],
     "b2cla": [],
     "b2csa": [],
     "exp": [],
     "cdnra": []
}
'

❗️
Test Environment Not Available

Response

The response includes the following Save GSTR-1 details below

Param	Type	Description	Example
reference_id	`string`	Reference ID	243255

📘
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 Save GSTR-1 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