curl --request POST \
--url https://api.sandbox.co.in/gst/compliance/tax-payer/gstrs/gstr-9/save \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--header 'x-api-key: <x-api-key>' \
--data '
{
"fp": "032024",
"table4": {
"b2c": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"b2b": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"exp": {
"txval": 1000,
"iamt": 20,
"csamt": 20
},
"sez": {
"txval": 1000,
"iamt": 20,
"csamt": 20
},
"deemed": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"at": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"rchrg": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"cr_nt": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"dr_nt": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"amd_pos": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"amd_neg": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
}
},
"table5": {
"zero_rtd": {
"txval": 1000
},
"sez": {
"txval": 1000
},
"rchrg": {
"txval": 1000
},
"exmt": {
"txval": 1000
},
"nil": {
"txval": 1000
},
"non_gst": {
"txval": 1000
},
"cr_nt": {
"txval": 1000
},
"dr_nt": {
"txval": 1000
},
"amd_pos": {
"txval": 1000
},
"amd_neg": {
"txval": 1000
}
},
"table6": {
"supp_non_rchrg": [
{
"itc_typ": "ip",
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
}
],
"supp_rchrg_unreg": [
{
"itc_typ": "ip",
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
}
],
"supp_rchrg_reg": [
{
"itc_typ": "ip",
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
}
],
"iog": [
{
"itc_typ": "ip",
"iamt": 20,
"csamt": 20
}
],
"ios": {
"iamt": 20,
"csamt": 20
},
"isd": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"itc_clmd": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"tran1": {
"camt": 20,
"samt": 20
},
"tran2": {
"camt": 20,
"samt": 20
},
"other": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
}
},
"table7": {
"rule37": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"rule39": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"rule42": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"rule43": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"sec17": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"revsl_tran1": {
"camt": 20,
"samt": 20
},
"revsl_tran2": {
"camt": 20,
"samt": 20
},
"other": [
{
"desc": "other1",
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
}
]
},
"table8": {
"itc_inwd_supp": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"itc_nt_availd": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"itc_nt_eleg": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"iog_taxpaid": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
}
},
"table9": {
"iamt": {
"txpyble": 1000
},
"camt": {
"txpyble": 1000
},
"samt": {
"txpyble": 1000
},
"csamt": {
"txpyble": 1000
},
"intr": {
"txpyble": 1000
},
"fee": {
"txpyble": 1000
},
"pen": {
"txpyble": 1000
},
"other": {
"txpyble": 1000
}
},
"table10": {
"itc_availd": {
"csamt": 20,
"samt": 20,
"camt": 20,
"iamt": 20
},
"itc_rvsl": {
"csamt": 20,
"samt": 20,
"camt": 20,
"iamt": 20
},
"dbn_amd": {
"csamt": 20,
"samt": 20,
"txval": 1000,
"camt": 20,
"iamt": 20
},
"cdn_amd": {
"csamt": 20,
"samt": 20,
"txval": 1000,
"camt": 20,
"iamt": 20
}
},
"table14": {
"iamt": {
"txpyble": 1000,
"txpaid": 1000
},
"camt": {
"txpyble": 1000,
"txpaid": 1000
},
"samt": {
"txpyble": 1000,
"txpaid": 1000
},
"csamt": {
"txpyble": 1000,
"txpaid": 1000
},
"intr": {
"txpyble": 1000,
"txpaid": 1000
}
},
"table15": {
"rfd_clmd": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"rfd_sanc": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"rfd_rejt": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"rfd_pend": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"tax_dmnd": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20,
"intr": 20,
"fee": 20,
"pen": 20
},
"tax_paid": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20,
"intr": 20,
"fee": 20,
"pen": 20
},
"dmnd_pend": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20,
"intr": 20,
"fee": 20,
"pen": 20
}
},
"table16": {
"comp_supp": {
"txval": 1000
},
"deemed_supp": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"not_returned": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
}
},
"table17": {
"items": [
{
"hsn_sc": "99",
"txval": 10000,
"isconcesstional": "N",
"rt": 5,
"iamt": 0,
"camt": 250,
"samt": 250,
"csamt": 0
},
{
"hsn_sc": "995411",
"txval": 10000,
"isconcesstional": "N",
"rt": 5,
"iamt": 0,
"camt": 250,
"samt": 250,
"csamt": 0
},
{
"hsn_sc": "4502",
"uqc": "BDL",
"qty": 1,
"txval": 10000,
"isconcesstional": "N",
"rt": 5,
"iamt": 0,
"camt": 250,
"samt": 250,
"csamt": 500
}
]
},
"table18": {
"items": [
{
"hsn_sc": "1203",
"uqc": "BAL",
"qty": 1,
"txval": 10000,
"isconcesstional": "N",
"rt": 5,
"iamt": 0,
"camt": 250,
"samt": 250,
"csamt": 0
},
{
"hsn_sc": "999900",
"txval": 10000,
"isconcesstional": "N",
"rt": 5,
"iamt": 0,
"camt": 250,
"samt": 250,
"csamt": 0
}
]
}
}
'{
"code": 200,
"data": {
"status_cd": "0",
"error": {
"error_cd": "RT-9AS-1008",
"message": "To file your annual return, filing of all applicable returns/statements (GSTR-1 and GSTR-3B) are mandatory. File your pending applicable return(s)/ statement(s) and try again."
}
},
"timestamp": 1763446641000,
"transaction_id": "2b3e8972-1486-48fd-ad85-4181d568633b"
}Save GSTR-9
Save the GSTR-9 with the required data across tables including outward supplies, input tax credits (ITC), and tax payments for the financial year with the GST department.
POST
/
gst
/
compliance
/
tax-payer
/
gstrs
/
gstr-9
/
save
curl --request POST \
--url https://api.sandbox.co.in/gst/compliance/tax-payer/gstrs/gstr-9/save \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--header 'x-api-key: <x-api-key>' \
--data '
{
"fp": "032024",
"table4": {
"b2c": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"b2b": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"exp": {
"txval": 1000,
"iamt": 20,
"csamt": 20
},
"sez": {
"txval": 1000,
"iamt": 20,
"csamt": 20
},
"deemed": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"at": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"rchrg": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"cr_nt": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"dr_nt": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"amd_pos": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"amd_neg": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
}
},
"table5": {
"zero_rtd": {
"txval": 1000
},
"sez": {
"txval": 1000
},
"rchrg": {
"txval": 1000
},
"exmt": {
"txval": 1000
},
"nil": {
"txval": 1000
},
"non_gst": {
"txval": 1000
},
"cr_nt": {
"txval": 1000
},
"dr_nt": {
"txval": 1000
},
"amd_pos": {
"txval": 1000
},
"amd_neg": {
"txval": 1000
}
},
"table6": {
"supp_non_rchrg": [
{
"itc_typ": "ip",
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
}
],
"supp_rchrg_unreg": [
{
"itc_typ": "ip",
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
}
],
"supp_rchrg_reg": [
{
"itc_typ": "ip",
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
}
],
"iog": [
{
"itc_typ": "ip",
"iamt": 20,
"csamt": 20
}
],
"ios": {
"iamt": 20,
"csamt": 20
},
"isd": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"itc_clmd": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"tran1": {
"camt": 20,
"samt": 20
},
"tran2": {
"camt": 20,
"samt": 20
},
"other": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
}
},
"table7": {
"rule37": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"rule39": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"rule42": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"rule43": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"sec17": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"revsl_tran1": {
"camt": 20,
"samt": 20
},
"revsl_tran2": {
"camt": 20,
"samt": 20
},
"other": [
{
"desc": "other1",
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
}
]
},
"table8": {
"itc_inwd_supp": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"itc_nt_availd": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"itc_nt_eleg": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"iog_taxpaid": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
}
},
"table9": {
"iamt": {
"txpyble": 1000
},
"camt": {
"txpyble": 1000
},
"samt": {
"txpyble": 1000
},
"csamt": {
"txpyble": 1000
},
"intr": {
"txpyble": 1000
},
"fee": {
"txpyble": 1000
},
"pen": {
"txpyble": 1000
},
"other": {
"txpyble": 1000
}
},
"table10": {
"itc_availd": {
"csamt": 20,
"samt": 20,
"camt": 20,
"iamt": 20
},
"itc_rvsl": {
"csamt": 20,
"samt": 20,
"camt": 20,
"iamt": 20
},
"dbn_amd": {
"csamt": 20,
"samt": 20,
"txval": 1000,
"camt": 20,
"iamt": 20
},
"cdn_amd": {
"csamt": 20,
"samt": 20,
"txval": 1000,
"camt": 20,
"iamt": 20
}
},
"table14": {
"iamt": {
"txpyble": 1000,
"txpaid": 1000
},
"camt": {
"txpyble": 1000,
"txpaid": 1000
},
"samt": {
"txpyble": 1000,
"txpaid": 1000
},
"csamt": {
"txpyble": 1000,
"txpaid": 1000
},
"intr": {
"txpyble": 1000,
"txpaid": 1000
}
},
"table15": {
"rfd_clmd": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"rfd_sanc": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"rfd_rejt": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"rfd_pend": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"tax_dmnd": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20,
"intr": 20,
"fee": 20,
"pen": 20
},
"tax_paid": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20,
"intr": 20,
"fee": 20,
"pen": 20
},
"dmnd_pend": {
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20,
"intr": 20,
"fee": 20,
"pen": 20
}
},
"table16": {
"comp_supp": {
"txval": 1000
},
"deemed_supp": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
},
"not_returned": {
"txval": 1000,
"iamt": 20,
"camt": 20,
"samt": 20,
"csamt": 20
}
},
"table17": {
"items": [
{
"hsn_sc": "99",
"txval": 10000,
"isconcesstional": "N",
"rt": 5,
"iamt": 0,
"camt": 250,
"samt": 250,
"csamt": 0
},
{
"hsn_sc": "995411",
"txval": 10000,
"isconcesstional": "N",
"rt": 5,
"iamt": 0,
"camt": 250,
"samt": 250,
"csamt": 0
},
{
"hsn_sc": "4502",
"uqc": "BDL",
"qty": 1,
"txval": 10000,
"isconcesstional": "N",
"rt": 5,
"iamt": 0,
"camt": 250,
"samt": 250,
"csamt": 500
}
]
},
"table18": {
"items": [
{
"hsn_sc": "1203",
"uqc": "BAL",
"qty": 1,
"txval": 10000,
"isconcesstional": "N",
"rt": 5,
"iamt": 0,
"camt": 250,
"samt": 250,
"csamt": 0
},
{
"hsn_sc": "999900",
"txval": 10000,
"isconcesstional": "N",
"rt": 5,
"iamt": 0,
"camt": 250,
"samt": 250,
"csamt": 0
}
]
}
}
'{
"code": 200,
"data": {
"status_cd": "0",
"error": {
"error_cd": "RT-9AS-1008",
"message": "To file your annual return, filing of all applicable returns/statements (GSTR-1 and GSTR-3B) are mandatory. File your pending applicable return(s)/ statement(s) and try again."
}
},
"timestamp": 1763446641000,
"transaction_id": "2b3e8972-1486-48fd-ad85-4181d568633b"
}Request body schema
View request body schema
View request body schema
Headers
GST taxpayer access token. For token-generation steps, refer to the Generate Taxpayer Session recipe, then pass the token in the authorization header.
API key for identification
API version
Query Parameters
Financial year. E.g., FY 2023-24
Example:
"{{financial_year}}"
Body
application/json
Public request body for Save Gstr9.
The fp value provided in the request.
The table4 value provided in the request.
Show child attributes
Show child attributes
The table5 value provided in the request.
Show child attributes
Show child attributes
The table6 value provided in the request.
Show child attributes
Show child attributes
The table7 value provided in the request.
Show child attributes
Show child attributes
The table8 value provided in the request.
Show child attributes
Show child attributes
The table9 value provided in the request.
Show child attributes
Show child attributes
The table10 value provided in the request.
Show child attributes
Show child attributes
The table14 value provided in the request.
Show child attributes
Show child attributes
The table15 value provided in the request.
Show child attributes
Show child attributes
The table16 value provided in the request.
Show child attributes
Show child attributes
The table17 value provided in the request.
Show child attributes
Show child attributes
The table18 value provided in the request.
Show child attributes
Show child attributes
Response
200 - application/json
GSTR-1/GSTR-3B not filed / 200 Success
- Option 1
- Option 2
A GSTN success or GSTN business-failure response. Both variants use HTTP 200.
The HTTP status code reported in the response body.
Available options:
200 Example:
200
The response timestamp in Unix epoch milliseconds.
Example:
1763446641000
The transaction identifier used to trace the request.
Example:
"41bb8041-fb83-4654-8d75-85a19f329158"
The GSTN success wrapper.
Show child attributes
Show child attributes