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
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?
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?
What is the GSTR-1 filing workflow?
- Authenticate using OTP to start a 6-hour session
- Save invoice data using the Save GSTR-1 API
- Check return status for errors
- Call Proceed to File to generate summary
- Generate EVC OTP for authorization
- File the return using File GSTR-1 API
- Verify filing status
What's the difference between B2B and B2CL?
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
B2CL (B2C Large): Inter-state invoices to unregistered recipients exceeding ₹2.5 lakhs
What is EVC OTP?
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?
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?
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.