iotoms Docs

Get India GSTR-3B summary

GET
/api/v1/reports/tax/india/gstr3b

Returns the monthly GSTR-3B summary: total sales subtotal, output GST and net GST payable. month (1 to 12) and year (2017 or later) are required, and the merchant must have a GSTIN set. Input tax credit is not yet calculated and is reported as zero.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Query Parameters

month*integer

Filing month (1–12)

Formatint32
year*integer

Filing year (>= 2017)

Formatint32

Header Parameters

X-TenantID*string

Tenant identifier

Response Body

OK

*/*
  1. response
status*string

Outcome of the call: SUCCESS when the request worked, ERROR when it did not.

message*string

Short human-readable message describing the result, for logs or display; do not parse it.

data?

The GSTR-3B summary for the filing month.

Example Request
curl -X GET 'https://beta.iotoms.com/api/v1/reports/tax/india/gstr3b?month=0&year=0' \  -H 'X-TenantID: your-tenant-code'
Example Response
{  "status": "string",  "message": "string",  "data": {    "gstin": "string",    "period": "string",    "month": 0,    "year": 0,    "outwardTaxableSupplies": 0,    "outputTax": {      "cgst": 0,      "sgst": 0,      "igst": 0,      "cess": 0,      "total": 0    },    "itcAvailable": {      "cgst": 0,      "sgst": 0,      "igst": 0,      "cess": 0,      "total": 0    },    "netTaxPayable": {      "cgst": 0,      "sgst": 0,      "igst": 0,      "cess": 0,      "total": 0    }  }}