GSTR-1 is a sales return that is required to be filed by every GST-registered person or entity. Sandbox API for getting small business-to-consumer(B2CSA) invoice(more than 2.5 lakhs) details with amendments for a return period of the authenticated taxpayer.

API Pricing Image


  • Get all B2C HSN invoices with amendments for a return period for the authenticated taxpayer (gstin) for the particular year and month.


HTTP MethodResource

API Endpoint  Contact Us  Free Trial


Follow the below guidelines to pass GSTIN, year & month for getting small business-to-consumer(B2CSA) invoice details with amendments.

Path Parameters

gstinstring15-character alpha-numeric unique identifier assigned to business entities registering under the GST regime22AAAAA0000A1Z5
yearstringYear for which Advance Tax needs to be fetched.2020
monthstringMonth for which Advance Tax needs to be fetched.01

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

curl --request GET \
     --url \
     --header 'Authorization: xxxxxxxxxx' \
     --header 'accept: application/json' \
     --header 'x-api-key: xxxxxxxxxx' \
     --header 'x-api-version: 1.0'


Test Environment Not Available


The response includes the following small B2B invoices details with amendments below

  • b2csa entity
omonstringOriginal Month of Invoice122016
oposstringPlace of Supply04
sply_tystringSupply TypeINTER
etinstringEcom Operator Gstin01AABCE5507R1C4
posstringPlace of Supply05
flagstringTax payer action"D"
typstringTypeE/OE (Ecom/Other than Ecom)
diff_percentnumDifferential percentage.65 (65%)
List {itms}ItemsLook at the table below
  • itms entity
txvalnumTaxable value of Goods or Service as per invoice110
iamtnumIGST Amount as per invoice10
camtnumCGST Amount as per invoice0
samtnumSGST Amount as per invoice0
csamtnumcess Amount as per invoice10

Response Caching

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

Wallet Charges

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


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