Save GSTR-1

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


  • 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.


API Endpoint  Contact Us  Free Trial


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

Path Parameters

gstinstring15-character alpha-numeric unique identifier assigned to business entities registering under the GST regime22AAAAA0000A1Z5
yearstringYear for which Advance Tax needs to be fetched.2020
monthstringMonth for which Advance Tax needs to be fetched.01

Request Body


gstinstringGSTIN of the Tax Payer22AAAAA0000A1Z5
fpstringReturn period032020
gtnumGross Turnover in the preceding Financial Year1000.00
cur_gtnumGross Turnover for the period1000.00
atobjectGSTR-1 AT
ataobjectGSTR-1 ATA
b2bobjectGSTR-1 B2B
b2baobjectGSTR-1 B2BA
b2clobjectGSTR-1 B2CL
b2claobjectGSTR-1 B2CLA
b2csobjectGSTR-1 B2CS
b2csaobjectGSTR-1 B2CSA
cdnrobjectGSTR-1 CDNR
cdnraobjectGSTR-1 CDNRA
cdnurobjectGSTR-1 CDNUR
cdnuraobjectGSTR-1 CDNURA
doc_issueobjectGSTR-1 Document Issued
expobjectGSTR-1 EXP
expaobjectGSTR-1 EXPA
hsnobjectGSTR-1 HSN Summary
nilobjectGSTR-1 NIL Supplies

The CURL would look like this

curl --request POST \
     --url \
     --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


The response includes the following Save GSTR-1 details below

reference_idstringReference ID243255


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.


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