GSTR-1 B2CS

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(B2CS) invoice(less than 2.5 lakhs) details for a return period of the authenticated taxpayer.

API Pricing Image

About

  • Get all B2C HSN invoices for a return period for the authenticated taxpayer (gstin) for the particular year and month.
  • You also need to provide the state_code.

Endpoint

HTTP MethodResource
Get/gsp/tax-payer/{gstin}/gstrs/gstr-1/b2cs/{year}/{month}

API Endpoint  Contact Us  Free Trial

Request

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

Path Parameters

ParamTypeDescriptionExample
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 https://api.sandbox.co.in/gsp/tax-payer/22AAAAA0000A1Z5/gstrs/gstr-1/b2cs/2020/01 \
     --header 'Authorization: xxxxxxxxxx' \
     --header 'accept: application/json' \
     --header 'x-api-key: xxxxxxxxxx' \
     --header 'x-api-version: 1.0'

❗️

Test Environment Not Available


Response

The response includes the following small B2B invoices details below

ParamTypeDescriptionExample
posstringPlace of Supply06
chksumstringInvoice Check sum valueASDFGJKLPTBBJKBJKBBJKBB
sply_lystringSupply TypeINTER
rtnumRate as per invoice5
typstringTypeE
etinstringEcom Operator Gstin20ABCDE7588L1ZJ
txvalnumTaxable value of Goods or Service as per invoice110
iamtnumIGST Amount as per invoice10
camtnumCGST Amount as per invoice1000.00
samtnumSGST Amount as per invoice1000.00
csamtnumCess Amount as per invoice10
flagstringInvoice StatusN
diff_percentnumDifferential percentage.65 (65%)

Response Caching

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

Wallet Charges

Since GSTR-1 B2CS 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