iotoms Docs

Get India GSTR-1 report

GET
/api/v1/reports/tax/india/gstr1

Returns the GSTR-1 outward supplies report for the filing month: B2B invoices to registered customers, large inter-state B2C invoices (2,50,000 rupees or more) and a summary of other B2C sales. month and year are required; the merchant must have a GSTIN set.

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-1 outward supplies report for the filing month.

Example Request
curl -X GET 'https://beta.iotoms.com/api/v1/reports/tax/india/gstr1?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,    "b2b": [      {        "customerGstin": "string",        "customerName": "string",        "invoices": [          {            "invoiceNumber": "string",            "invoiceDate": "2019-08-24",            "cartId": "string",            "supplyType": "string",            "placeOfSupply": "string",            "reverseCharge": true,            "grandTotal": 0,            "taxableValue": 0,            "totalCgst": 0,            "totalSgst": 0,            "totalIgst": 0,            "items": [              {                "itemId": "string",                "description": "string",                "hsnCode": "string",                "quantity": 0,                "unitPrice": 0,                "taxableValue": 0,                "gstRatePercent": 0,                "cgstRate": 0,                "cgstAmount": 0,                "sgstRate": 0,                "sgstAmount": 0,                "igstRate": 0,                "igstAmount": 0,                "totalTax": 0,                "lineTotal": 0              }            ]          }        ]      }    ],    "b2cl": [      {        "placeOfSupply": "string",        "invoices": [          {            "invoiceNumber": "string",            "invoiceDate": "2019-08-24",            "cartId": "string",            "supplyType": "string",            "placeOfSupply": "string",            "reverseCharge": true,            "grandTotal": 0,            "taxableValue": 0,            "totalCgst": 0,            "totalSgst": 0,            "totalIgst": 0,            "items": [              {                "itemId": "string",                "description": "string",                "hsnCode": "string",                "quantity": 0,                "unitPrice": 0,                "taxableValue": 0,                "gstRatePercent": 0,                "cgstRate": 0,                "cgstAmount": 0,                "sgstRate": 0,                "sgstAmount": 0,                "igstRate": 0,                "igstAmount": 0,                "totalTax": 0,                "lineTotal": 0              }            ]          }        ]      }    ],    "b2cs": [      {        "placeOfSupply": "string",        "supplyType": "string",        "taxableValue": 0,        "cgstAmount": 0,        "sgstAmount": 0,        "igstAmount": 0      }    ],    "totalTaxableValue": 0,    "totalCgst": 0,    "totalSgst": 0,    "totalIgst": 0,    "totalTax": 0  }}