This page serves as a repository of test cases for the GST APIs. The test environment can be used to simulate workflows and test out integrations before going live. To hit the test environment, import our comprehensive Postman collections and hit the APIs with the test environment host URL.
Endpoints
| Environment | Host URL |
|---|---|
| Test | https://test-api.sandbox.co.in |
| Production | https://api.sandbox.co.in |
Compliance API
Search GSTIN
| Run in Postman | Response | Remarks |
|---|---|---|
| Test request | 200 | Success response |
| Test request | 200 | Success response |
| Test request | 200 | No records found |
| Test request | 422 | Invalid GSTIN pattern |
Track GST Returns
| Run in Postman | Response | Remarks |
|---|---|---|
| Test request | 200 | Success response |
| Test request | 200 | Select valid FY |
| Test request | 200 | No Record found |
| Test request | 422 | Invalid GSTIN pattern |
Search GSTIN by PAN and State code
| Run in Postman | Response | Remarks |
|---|---|---|
| Test request | 200 | Success response |
| Test request | 200 | No records found |
Taxpayer Auth: Generate OTP
| Run in Postman | Response | Remarks |
|---|---|---|
| Test request | 200 | Success response |
Taxpayer Auth: Verify OTP
| Run in Postman | Response | Remarks |
|---|---|---|
| Test request | 200 | Success response |
Refresh Taxpayer Access Token
| Run in Postman | Response | Remarks |
|---|---|---|
| Test request | 200 | Success response |
Taxpayer Logout
| Run in Postman | Response | Remarks |
|---|---|---|
| Test request | 200 | Success response |
Generate EVC OTP
| Run in Postman | Response | Remarks |
|---|---|---|
| Test request | 200 | Success response |
| Test request | 200 | Not authorized signatory |
Get GSTR-1 Documents
| Document type | Run in Postman | Response | Remarks |
|---|---|---|---|
| AT | Test request | 200 | No data found |
| ATA | Test request | 200 | No data found |
| B2B | Test request | 200 | 200 Success |
| B2B | Test request | 200 | Filtered by counterparty GSTIN |
| B2B | Test request | 200 | No data found |
| B2BA | Test request | 200 | No data found |
| B2CL | Test request | 200 | No data found |
| B2CLA | Test request | 200 | No data found |
| B2CS | Test request | 200 | 200 Sucess |
| B2CS | Test request | 200 | No data found |
| B2CSA | Test request | 200 | 200 Success |
| B2CSA | Test request | 200 | No data found |
| CDNR | Test request | 200 | No data found |
| CDNRA | Test request | 200 | No data found |
| CDNUR | Test request | 200 | No data found |
| CDNURA | Test request | 200 | No data found |
| Documents issued | Test request | 200 | 200 Success |
| Documents issued | Test request | 200 | No data found |
| EXP | Test request | 200 | No data found |
| EXPA | Test request | 200 | No data found |
| NIL Supplies | Test request | 200 | 200 Success |
| NIL Supplies | Test request | 200 | No data found |
| HSN Summary | Test request | 200 | 200 Success |
| HSN Summary | Test request | 200 | No data found |
Save GSTR-1
| Run in Postman | Response | Remarks |
|---|---|---|
| Test request | 200 | Success response |
e-Invoice Authentication
| Run in Postman | Response | Remarks |
|---|---|---|
| Test request | 200 | Authenticated |
| Test request | 200 | Incorrect password |
| Test request | 200 | Incorrect user id/User does not exists |
| Test request | 200 | Invalid GSTIN for this user |
Generate e-Invoice
| Run in Postman | Response | Remarks |
|---|---|---|
| Test request | 200 | e-Invoice generated |
| Test request | 200 | e-Invoice with E-Way Bill generated |
| Test request | 200 | Duplicate IRN |
| Test request | 200 | Supplier state code does not match |
| Test request | 200 | IRN already generated and cancelled |
Get e-Invoice by IRN
| Run in Postman | Response | Remarks |
|---|---|---|
| Test request | 200 | e-Invoice details |
| Test request | 200 | e-Invoice generated more than 2 days ago |
| Test request | 200 | Cancelled IRN details |
| Test request | 200 | IRN data not available |
Get e-Invoice by document data
| Run in Postman | Response | Remarks |
|---|---|---|
| Test request | 200 | e-Invoice details |
| Test request | 200 | Cancelled e-Invoice details |
| Test request | 200 | IRN not found |
Cancel e-Invoice
| Run in Postman | Response | Remarks |
|---|---|---|
| Test request | 200 | e-Invoice cancelled |
| Test request | 200 | e-Invoice more than 24 hrs old |
| Test request | 200 | Cannot be cancelled as E-Way bill is active |
Generate E-Way Bill by IRN
| Run in Postman | Response | Remarks |
|---|---|---|
| Test request | 200 | E-Way Bill generated |
| Test request | 200 | E-Way Bill already generated |
| Test request | 200 | E-Way Bill cannot be generated for services |
| Test request | 200 | Distance too high |
| Test request | 200 | Regular vehicle not valid in ship mode |
Get E-Way Bill by IRN
| Run in Postman | Response | Remarks |
|---|---|---|
| Test request | 200 | Success response |
Search GSTIN Details (e-Invoice)
| Run in Postman | Response | Remarks |
|---|---|---|
| Test request | 200 | Success response |
| Test request | 200 | Data not available |