File GSTR-3B

File GSTR-3B by passing the GSTR-3B Details response after offsetting liabilities for the authenticated taxpayer.

POST /gst/compliance/tax-payer/gstrs/gstr-3b/{year}/{month}/file

cURL

200 Success

curl --request POST \
  --url https://api.sandbox.co.in/gst/compliance/tax-payer/gstrs/gstr-3b/{year}/{month}/file \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "tx_pmt": {
    "net_tax_pay": [
      {
        "sgst": {
          "intr": 0,
          "tx": 4841,
          "fee": 0
        },
        "liab_ldg_id": 0,
        "tran_desc": "Other than Reverse Charge",
        "cgst": {
          "intr": 0,
          "tx": 4841,
          "fee": 0
        },
        "cess": {
          "intr": 0,
          "tx": 0,
          "fee": 0
        },
        "igst": {
          "intr": 0,
          "tx": 259471,
          "fee": 0
        },
        "trans_typ": 30002
      },
      {
        "sgst": {
          "intr": 0,
          "tx": 9000,
          "fee": 0
        },
        "liab_ldg_id": 0,
        "tran_desc": "Reverse charge and supplies made u/s 9(5)",
        "cgst": {
          "intr": 0,
          "tx": 9000,
          "fee": 0
        },
        "cess": {
          "intr": 0,
          "tx": 0,
          "fee": 0
        },
        "igst": {
          "intr": 0,
          "tx": 0,
          "fee": 0
        },
        "trans_typ": 30003
      }
    ],
    "adjnegliab": [],
    "pdnls": [],
    "pdcash": [
      {
        "liab_ldg_id": 757163094,
        "spd": 0,
        "c_intrpd": 0,
        "i_lfeepd": 0,
        "cspd": 0,
        "s_intrpd": 0,
        "trans_typ": 30002,
        "i_intrpd": 0,
        "s_lfeepd": 0,
        "cpd": 0,
        "c_lfeepd": 0,
        "cs_intrpd": 0,
        "cs_lfeepd": 0,
        "ipd": 44357
      },
      {
        "liab_ldg_id": 757163095,
        "spd": 9000,
        "c_intrpd": 0,
        "i_lfeepd": 0,
        "cspd": 0,
        "s_intrpd": 0,
        "trans_typ": 30003,
        "i_intrpd": 0,
        "s_lfeepd": 0,
        "cpd": 9000,
        "c_lfeepd": 0,
        "cs_intrpd": 0,
        "cs_lfeepd": 0,
        "ipd": 0
      }
    ],
    "pditc": {
      "s_pds": 4841,
      "liab_ldg_id": 757163094,
      "c_pdi": 0,
      "cs_pdcs": 0,
      "s_pdi": 0,
      "i_pdi": 182450,
      "c_pdc": 4841,
      "i_pdc": 16332,
      "i_pds": 16332,
      "trans_typ": 30002
    },
    "tx_py": [
      {
        "sgst": {
          "intr": 0,
          "tx": 0,
          "fee": 0
        },
        "liab_ldg_id": 757163094,
        "tran_desc": "Other than Reverse Charge",
        "cgst": {
          "intr": 0,
          "tx": 0,
          "fee": 0
        },
        "cess": {
          "intr": 0,
          "tx": 0,
          "fee": 0
        },
        "igst": {
          "intr": 0,
          "tx": 0,
          "fee": 0
        },
        "trans_typ": 30002
      },
      {
        "sgst": {
          "intr": 0,
          "tx": 0,
          "fee": 0
        },
        "liab_ldg_id": 757163095,
        "tran_desc": "Reverse charge and supplies made u/s 9(5)",
        "cgst": {
          "intr": 0,
          "tx": 0,
          "fee": 0
        },
        "cess": {
          "intr": 0,
          "tx": 0,
          "fee": 0
        },
        "igst": {
          "intr": 0,
          "tx": 0,
          "fee": 0
        },
        "trans_typ": 30003
      }
    ]
  },
  "eco_dtls": {
    "eco_reg_sup": {
      "samt": 0,
      "csamt": 0,
      "txval": 0,
      "camt": 0,
      "iamt": 0
    },
    "eco_sup": {
      "samt": 0,
      "csamt": 0,
      "txval": 0,
      "camt": 0,
      "iamt": 0
    }
  },
  "sup_details": {
    "osup_zero": {
      "samt": 0,
      "csamt": 0,
      "txval": 0,
      "camt": 0,
      "iamt": 0
    },
    "osup_nil_exmp": {
      "samt": 0,
      "csamt": 0,
      "txval": 0,
      "camt": 0,
      "iamt": 0
    },
    "osup_nongst": {
      "samt": 0,
      "csamt": 0,
      "txval": 0,
      "camt": 0,
      "iamt": 0
    },
    "osup_det": {
      "samt": 4841.23,
      "csamt": 0,
      "txval": 1495299.69,
      "camt": 4841.23,
      "iamt": 259471.16
    },
    "isup_rev": {
      "samt": 9000,
      "csamt": 0,
      "txval": 100000,
      "camt": 9000,
      "iamt": 0
    }
  },
  "intr_ltfee": {
    "ltfee_details": {
      "samt": 0,
      "csamt": 0,
      "camt": 0,
      "iamt": 0
    },
    "intr_details": {
      "samt": 0,
      "csamt": 0,
      "camt": 0,
      "iamt": 0
    }
  },
  "inter_sup": {
    "unreg_details": [
      {
        "pos": "27",
        "txval": 846.61,
        "iamt": 152.39
      },
      {
        "pos": "07",
        "txval": 1693.22,
        "iamt": 304.78
      },
      {
        "pos": "29",
        "txval": 149013.05,
        "iamt": 26822.27
      }
    ],
    "comp_details": [
      {
        "pos": "33",
        "txval": 1157.31,
        "iamt": 208.32
      }
    ],
    "uin_details": []
  },
  "itc_elg": {
    "itc_avl": [
      {
        "samt": 0,
        "csamt": 0,
        "ty": "IMPG",
        "camt": 0,
        "iamt": 0
      },
      {
        "samt": 0,
        "csamt": 0,
        "ty": "IMPS",
        "camt": 0,
        "iamt": 0
      },
      {
        "samt": 9000,
        "csamt": 0,
        "ty": "ISRC",
        "camt": 9000,
        "iamt": 0
      },
      {
        "samt": 0,
        "csamt": 0,
        "ty": "ISD",
        "camt": 0,
        "iamt": 0
      },
      {
        "samt": 12173,
        "csamt": 0,
        "ty": "OTH",
        "camt": 12173,
        "iamt": 182450
      }
    ],
    "itc_net": {
      "samt": 21173,
      "csamt": 0,
      "camt": 21173,
      "iamt": 182450
    },
    "itc_rev": [
      {
        "samt": 0,
        "csamt": 0,
        "ty": "RUL",
        "camt": 0,
        "iamt": 0
      },
      {
        "samt": 0,
        "csamt": 0,
        "ty": "OTH",
        "camt": 0,
        "iamt": 0
      }
    ],
    "itc_inelg": [
      {
        "samt": 0,
        "csamt": 0,
        "ty": "RUL",
        "camt": 0,
        "iamt": 0
      },
      {
        "samt": 0,
        "csamt": 0,
        "ty": "OTH",
        "camt": 0,
        "iamt": 0
      }
    ]
  }
}
'

200

200 Success

{
  "code": 200,
  "data": {
    "status_cd": "1",
    "data": {
      "ack_num": "AB2410242527396 19/11/2024 16:23"
    }
  },
  "timestamp": 1763446641000,
  "transaction_id": "72da34f0-d6d1-4056-92e1-734fc29f0249"
}

Request body schema

View request body schema

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

year · string · required

month · string · required

Query Parameters

pan · string · required

PAN of the authorized signatory

Example:

"{{pan}}"

otp · string · required

Generated EVC OTP

Example:

"575757"

Body

application/json

Public request body for File Gstr3b.

tx_pmt · object

The tx pmt value provided in the request.

Show child attributes

eco_dtls · object

The eco dtls value provided in the request.

Show child attributes

sup_details · object

The sup details value provided in the request.

Show child attributes

intr_ltfee · object

The intr ltfee value provided in the request.

Show child attributes

inter_sup · object

The inter sup value provided in the request.

Show child attributes

itc_elg · object

The itc elg value provided in the request.

Show child attributes

Response

200 - application/json

200 Success / 200 You cannot file Nil return

Option 1

Option 2

A GSTN success or GSTN business-failure response. Both variants use HTTP 200.

code · enum<integer> · required

The HTTP status code reported in the response body.

Available options: 200

Example:

200

timestamp · integer<int64> · required

The response timestamp in Unix epoch milliseconds.

Example:

1763446641000

transaction_id · string · required

The transaction identifier used to trace the request.

Example:

"41bb8041-fb83-4654-8d75-85a19f329158"

data · object · required

The GSTN success wrapper.

Show child attributes