File GSTR-1

GSTR-1 is a sales return that is required to be filed by every GST-registered person or entity. Sandbox API for filling the GSTR1 of authenticated taxpayers.

API Pricing Image

Overview

  • This is the fourth & final step of GSTR-1 filing for the authenticated taxpayer (gstin) for a particular year and month.
  • The previous OTP received from the previous step will be used as a Query parameter.

Generate OTP to file GSTR through EVC

Make sure that the previous steps have been completed

This will ensure you are able to file your GSTR-1. View the recipes over here

Endpoint

HTTP MethodResource
Post/gsp/tax-payer/{gstin}/{gstr}/evc/otp?pan={}pan{}

API Endpoint  Contact Us  Free Trial

Path Parameters

ParamTypeDescriptionExample
gstinstring15-character alpha-numeric unique identifier assigned to business entities registering under the GST regime22AAAAA0000A1Z5
yearstringYear for which taxpayer is filing GSTR-12021
monthstringMonth for which taxpayer is filing GSTR-101

Query Parameters

ParamTypeDescriptionExample
pan (required)stringPAN number of authorised signatory.AAAAA0000A
otp (required)stringEVC Generated OTP000000

📘

Requires GSTR-1 Summary Response

You would need to add the response from that API in the JSON Request Body as shown below

curl --request POST \
     --url 'https://api.sandbox.co.in/gsp/tax-payer/22AAAAA0000A1Z5/gstrs/gstr-1/2020/01/file?pan=AAAAA0000A&evcotp=000000' \
     --header 'Authorization: xxxxxxxxxx' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: xxxxxxxxxx' \
     --header 'x-api-version: 1.0' \
     --data '
{
     "gstin": "19KLJIP2115A1ZL",
     "ret_period": "042021",
     "chksum": "0b194f5f9cfeb178a4d1440103641b81eb17728b9afd6691a3661aa9c3dd0f8d",
     "newSumFlag": true,
     "sec_sum": [
          {
               "sec_nm": "b2b",
               "chksum": "AflJufPlFStqKBZ",
               "ttl_rec": 10,
               "ttl_val": 12345,
               "ttl_igst": 124.99,
               "ttl_cgst": 3423,
               "ttl_sgst": 5589.87,
               "ttl_cess": 3423,
               "ttl_tax": 1234,
               "cpty_sum": [
                    {
                         "ctin": "20GRRHF2562D3A3",
                         "chksum": "AflJufPlFStqKBZ",
                         "ttl_rec": 10,
                         "ttl_val": 12345,
                         "ttl_igst": 124.99,
                         "ttl_cgst": 3423,
                         "ttl_sgst": 5589.87,
                         "ttl_cess": 3423,
                         "ttl_tax": 1234
                    }
               ]
          }
     ]
}
'

❗️

Test Environment Not Available


Response

The response includes the following File GSTR-1 details below

ParamTypeDescriptionExample
ack_numstringAcknowledgment number of the Filed GSTR-1ASDFSDF1241343

Response Caching

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

Wallet Charges

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