Upload GSTR-3B

GSTR-3B return is a simplified summary that you must file every month as a registered taxpayer. Sandbox API to upload GSTR-3B to GST Network.

API Pricing Image

Overview

  • Upload GSTR-3B RAW_BODY to GSTN System for the authenticated taxpayer (gstin) for a particular year and month.

Endpoint

HTTP MethodResourceDescription
POST/gsp/tax-payer/{gstin}/gstrs/gstr-3b/{year}/{month}Takes in gstin, year and month and JSON RAW_BODY to upload it on to GSTN.

API Endpoint  Contact Us  Free Trial

Path Parameters

ParamTypeDescriptionExample
gstinstring15-character alpha-numeric unique identifier assigned to business entities registering under the GST regimeAAAAA0000A
yearstringYear for which Advance Tax needs to be fetched.2020
monthstringMonth for which Advance Tax needs to be fetched.01
curl --request POST \
     --url https://api.sandbox.co.in/gsp/tax-payer/22AAAAA0000A1Z5/gstrs/gstr-3b/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 '
{
     "ret_period": "022020",
     "inward_sup": {
          "isup_details": [
               {
                    "intra": 0,
                    "ty": "GST",
                    "inter": 0
               },
               {
                    "intra": 0,
                    "ty": "NONGST",
                    "inter": 0
               }
          ]
     },
     "sup_details": {
          "osup_nil_exmp": {
               "txval": 0
          },
          "osup_nongst": {
               "txval": 0
          },
          "osup_zero": {
               "csamt": 0,
               "iamt": 0,
               "txval": 0
          },
          "osup_det": {
               "samt": 0,
               "csamt": 0,
               "camt": 0,
               "iamt": 0,
               "txval": 0
          },
          "isup_rev": {
               "samt": 0,
               "csamt": 0,
               "camt": 0,
               "iamt": 0,
               "txval": 0
          }
     },
     "intr_ltfee": {
          "intr_details": {
               "csamt": 0,
               "samt": 0,
               "camt": 0,
               "iamt": 0
          }
     },
     "inter_sup": {
          "comp_details": [],
          "uin_details": [],
          "unreg_details": []
     },
     "itc_elg": {
          "itc_avl": [
               {
                    "samt": 0,
                    "csamt": 0,
                    "camt": 0,
                    "ty": "IMPG",
                    "iamt": 0
               },
               {
                    "samt": 0,
                    "csamt": 0,
                    "camt": 0,
                    "ty": "IMPS",
                    "iamt": 0
               },
               {
                    "samt": 0,
                    "csamt": 0,
                    "camt": 0,
                    "ty": "ISRC",
                    "iamt": 0
               },
               {
                    "samt": 0,
                    "csamt": 0,
                    "camt": 0,
                    "ty": "ISD",
                    "iamt": 0
               },
               {
                    "samt": 0,
                    "csamt": 0,
                    "camt": 0,
                    "ty": "OTH",
                    "iamt": 0
               }
          ],
          "itc_rev": [
               {
                    "csamt": 0,
                    "samt": 0,
                    "camt": 0,
                    "ty": "RUL",
                    "iamt": 0
               },
               {
                    "csamt": 0,
                    "samt": 0,
                    "camt": 0,
                    "ty": "OTH",
                    "iamt": 0
               }
          ],
          "itc_net": {
               "csamt": 0,
               "samt": 0,
               "camt": 0,
               "iamt": 0
          },
          "itc_inelg": [
               {
                    "csamt": 0,
                    "samt": 0,
                    "camt": 0,
                    "ty": "RUL",
                    "iamt": 0
               },
               {
                    "csamt": 0,
                    "samt": 0,
                    "camt": 0,
                    "ty": "OTH",
                    "iamt": 0
               }
          ]
     },
     "gstin": "24AAACJ3770E2ZZ"
}
'

Request Body

  • RAW_BODY
ParamTypeDescriptionExample
gstinstring24AAACJ3770E2ZZ
ret_periodnum022020
inward_supobjectLook BelowLook Below
sup_detailsobjectLook BelowLook Below
intr_ltfeeobjectLook BelowLook Below
inter_supobjectLook BelowLook Below
itc_elgstringLook BelowLook Below
b2csobjectLook BelowLook Below
txpdobjectLook BelowLook Below
ataobjectLook BelowLook Below
invobjectLook BelowLook Below
  • inward_sup entity
ParamTypeDescriptionExample
intranum0
tystringGST
internum0
  • sup_details entity
ParamTypeDescriptionExample
osup_nil_exmpobject"txval": 0
osup_nongstobject"txval": 0
osup_zeroobject"csamt": 0,
"iamt": 0,
"txval": 0
osup_detobject"samt": 0,
"csamt": 0,
"camt": 0,
"iamt": 0,
"txval": 0
isup_revobject"samt": 0,
"csamt": 0,
"camt": 0,
"iamt": 0,
"txval": 0
  • intr_ltfee entity
ParamTypeDescriptionExample
intr_ltfee"csamt": 0,
"samt": 0,
"camt": 0,
"iamt": 0
  • inter_sup entity
ParamTypeDescriptionExample
comp_details
uin_details
unreg_details
  • itc_elg entity
ParamTypeDescriptionExample
itc_avl"samt": 0,
"csamt": 0,
"camt": 0,
"ty": "IMPG",
"iamt": 0
itc_rev"csamt": 0,
"samt": 0,
"camt": 0,
"ty": "RUL",
"iamt": 0
itc_net"csamt": 0,
"samt": 0,
"camt": 0,
"iamt": 0
itc_inelg"csamt": 0,
"samt": 0,
"camt": 0,
"ty": "RUL",
"iamt": 0

Once the values are added, Your curl will look something like this

❗️

Test Environment Not Available


Response

The response includes the following GSTR-3B details below

ParamTypeDescriptionExample
reference_idstring243255

Response Caching

Response caching is not available for this API. Learn more about our response caching mechanism here

Wallet Charges

Since Upload GSTR-3B is a Paid API, a wallet charge of INR 0.25 + GST per API call will be applicable.

Versioning

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