Overview

File GSTR-1 returns programmatically using Sandbox APIs—manage outward supplies, amendments, and compliance

GSTR-1 API

GSTR-1 is a monthly or quarterly return for reporting outward supplies (sales). Use these APIs to save invoice data, retrieve summaries, and file returns directly to the GST portal.

This API enables automated GSTR-1 compliance covering all invoice types, amendments, credit/debit notes, exports, and HSN summaries.

All GSTR-1 tables

Save and retrieve B2B, B2C, exports, credit/debit notes, and nil supplies across all GSTR-1 tables.

Full filing workflow

From saving invoices to generating EVC OTP and filing—handle the entire compliance workflow via API.

How it works

1. Authenticate taxpayer

   Generate OTP and verify to start a taxpayer session valid for 6 hours.

2. Save invoices

   Upload invoice data (B2B, B2C, exports, CDN, etc.) to the GST portal.

3. Check return status

   Verify saved data and check for errors or warnings.

4. Proceed to file

   Generate the summary and mark the return ready for filing.

5. Get summary

   Retrieve table-wise summary of GSTR-1 data for review.

6. Generate EVC OTP

   Request OTP for Electronic Verification Code to authorize filing.

7. File return

   Submit the GSTR-1 return to the GST portal.

8. Verify filing status

   Confirm successful filing and retrieve acknowledgment.

Recipes

Step-by-step guides for common GSTR-1 workflows:

File GSTR-1

Complete workflow to file GSTR-1 with outward supplies, amendments, and credit/debit notes.

File Nil GSTR-1

File a nil return when there are no outward supplies for the period.

API categories

Document APIs

Retrieve invoice data for each GSTR-1 table (B2B, B2C, exports, CDN, HSN, etc.)

Filing APIs

Save data, proceed to file, generate summary, and submit returns

Return Status

Check status after saving—view errors and validation info

Errors & Troubleshooting

Understand error codes and resolve common issues

Document APIs

Retrieve invoice and supply data for each GSTR-1 table:

API	GSTR-1 Table	Description
GSTR-1 AT	11A	Advances received (tax payable, invoice not issued)
GSTR-1 ATA	11A (Amendments)	Amendment of advances reported earlier
GSTR-1 B2B	4A, 4B, 6B, 6C	B2B invoices (incl. SEZ supplies & Deemed exports)
GSTR-1 B2BA	9A	Amendment of B2B invoices
GSTR-1 B2CL	5A, 5B	B2C Large invoices (inter-state above threshold)
GSTR-1 B2CLA	9A	Amendment of B2C Large invoices
GSTR-1 B2CS	7	B2C Small (rate-wise consolidated)
GSTR-1 B2CSA	10	Amendment of B2C Small (Table 7)
GSTR-1 CDNR	9B	Credit/Debit Notes to registered persons
GSTR-1 CDNRA	9C	Amendment of CDNR (registered)
GSTR-1 CDNUR	9B	Credit/Debit Notes to unregistered persons
GSTR-1 CDNURA	9C	Amendment of CDNUR (unregistered)
GSTR-1 Document Issued	13	Documents issued (invoice series, DN/CN series)
GSTR-1 EXP	6A	Export invoices
GSTR-1 EXPA	9A (Exports)	Amendment of export invoices
GSTR-1 NIL Supplies	8A–8D	Nil rated / exempt / non-GST outward supplies
GSTR-1 HSN Summary	12	HSN-wise summary of outward supplies
GSTR-1 TXP	11B	Advance tax adjusted against invoices
GSTR-1 TXPA	11B (Amendments)	Amendments to advance adjustments
GSTR-1 ECOM	14	Supplies made through e-commerce operators
GSTR-1 ECOMA	14A	Amendments to Table 14
GSTR-1 SUPECO	15	Supplies u/s 9(5) where ECO is liable to pay tax
GSTR-1 SUPECOA	15A	Amendments to Table 15

Filing APIs

Save invoice data and complete the filing workflow:

API	Purpose
Save GSTR-1	Upload invoice JSON to GST portal
Reset GSTR-1	Reset saved return data
Proceed to File	Generate summary and mark return ready for filing
File GSTR-1	Submit the return to GST portal

Common APIs

Shared endpoints used across GSTR-1 workflow:

API	Purpose
Generate OTP	Start taxpayer authentication
Verify OTP	Complete authentication (6-hour session)
Generate EVC OTP	Request OTP for filing authorization
Return Status	Check status after saving return
Refresh Session	Extend taxpayer session
Logout	End taxpayer session

Common use cases

Use GSTR-1 APIs when you need to:

• Automate monthly or quarterly GSTR-1 filing
• Bulk upload B2B and B2C invoices from your ERP or accounting system
• Amend previously filed invoice data
• File credit/debit notes for registered and unregistered recipients
• Generate HSN-wise summaries for compliance
• Build GST compliance into your SaaS platform

Frequently Asked Questions

What is GSTR-1?

GSTR-1 is a monthly or quarterly return that registered taxpayers file to report details of outward supplies (sales). It includes B2B invoices, B2C sales, exports, credit/debit notes, and amendments.

What is the GSTR-1 filing workflow?

1. Authenticate using OTP to start a 6-hour session
2. Save invoice data using the Save GSTR-1 API
3. Check return status for errors
4. Call Proceed to File to generate summary
5. Generate EVC OTP for authorization
6. File the return using File GSTR-1 API
7. Verify filing status

What's the difference between B2B and B2CL?

B2B: Invoices to registered recipients (any value)
B2CL (B2C Large): Inter-state invoices to unregistered recipients exceeding ₹2.5 lakhs

What is EVC OTP?

Electronic Verification Code OTP is required to authorize filing. After calling Proceed to File, generate EVC OTP and include it in the File GSTR-1 request.

How long is the taxpayer session valid?

The session started after OTP verification is valid for 6 hours. Use the Refresh Session API to extend if needed.

Can I reset a saved return?

Yes, use the Reset GSTR-1 API to clear saved data before filing. This is useful if you need to re-upload corrected invoice data.