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.
Overview
- This is the fourth & final step of GSTR-1 filing for the authenticated taxpayer (
gstin) for a particularyearandmonth. - The previous
OTPreceived 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 Method | Resource |
|---|---|
Post | /gsp/tax-payer/{gstin}/{gstr}/evc/otp?pan={}pan{} |
Path Parameters
| Param | Type | Description | Example |
|---|---|---|---|
| gstin | string | 15-character alpha-numeric unique identifier assigned to business entities registering under the GST regime | 22AAAAA0000A1Z5 |
| year | string | Year for which taxpayer is filing GSTR-1 | 2021 |
| month | string | Month for which taxpayer is filing GSTR-1 | 01 |
Query Parameters
| Param | Type | Description | Example |
|---|---|---|---|
| pan (required) | string | PAN number of authorised signatory. | AAAAA0000A |
| evcotp (required) | string | EVC Generated OTP | 000000 |
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
| Param | Type | Description | Example |
|---|---|---|---|
| ack_num | string | Acknowledgment number of the Filed GSTR-1 | ASDFSDF1241343 |
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
Updated 2 months ago