Skip to main content
POST
/
gst
/
compliance
/
tax-payer
/
gstrs
/
gstr-3b
/
{year}
/
{month}
/
file
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 '
{
  "ret_period": "102024",
  "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
      }
    ]
  },
  "gstin": "24ABKCS2033B1ZV"
}
'
{
  "code": 200,
  "data": {
    "data": {
      "ack_num": "AB2410242527396 19/11/2024 16:23"
    },
    "status_cd": "1"
  },
  "timestamp": 1763446641000,
  "transaction_id": "72da34f0-d6d1-4056-92e1-734fc29f0249"
}

Documentation Index

Fetch the complete documentation index at: https://developer.sandbox.co.in/llms.txt

Use this file to discover all available pages before exploring further.

ā€‹
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

Year e.g. 2020

Example:

"{{year}}"

ā€‹
month
string
required

Month e.g. 01

Example:

"{{month}}"

Query Parameters

ā€‹
pan
string
required

PAN of the authorized signatory

Example:

"{{pan}}"

ā€‹
otp
string
required

Generated EVC OTP

Example:

"575757"

Body

application/json

The body is of type object.

Response

200 - application/json

200 Success / 200 You cannot file Nil return

ā€‹
code
number
Example:

200

ā€‹
data
object
ā€‹
timestamp
number
Example:

1763446641000

ā€‹
transaction_id
string
Example:

"72da34f0-d6d1-4056-92e1-734fc29f0249"