View And Track Returns
Introduction
The "View and Track Returns" API is a comprehensive solution for businesses and financial professionals to effortlessly monitor and verify GST (Goods and Services Tax) returns. With a simple API call using a GST number and financial year, users can access detailed information about filed GST returns, including filing dates, methods, periods, and types. This tool is invaluable for ensuring compliance with GST regulations and maintaining accurate financial records.
API details
Endpoint
POST https://api.signzy.app/api/v3/gst/returnsPOST https://api-preproduction.signzy.app/api/v3/gst/returnsRequest body parameters
Parameter | Data Type | Description | Required |
|---|---|---|---|
gstin financialYear | String String | GST Identiication Number Financial Year | Mandatory Mandatory |
consent | String | User's consent | Optional |
{
"gstin": "<gstin>",
"financialYear": "2017-18",
"consent":"Y/N"
}Request Headers
Name | Value | Required | Description |
|---|---|---|---|
Content-type | application/json | Mandatory | The type of content that the request body contains. |
Authorization | XXXXXXXXXXXXXXX | Mandatory | An authentication token to authorize the request. Reach out to the Signzy support team to get one created. |
Code Samples
curl --location 'https://api-preproduction.signzy.app/api/v3/gst/returns' \
--header 'Content-Type: application/json' \
--header 'Authorization: <Auth Token>' \
--data '{
"gstin": "<GST number>",
"financialYear": "2017-18",
"consent":"Y/N"
}'Response body parameters
Parameter | Data Type | Description |
|---|---|---|
result.filedReturns[0].valid | String | Whether the return is valid either true or false. |
result.filedReturns[0].methodOfFilling | String | The method of filing. |
result.filedReturns[0].dateOfFilling | String | The date of filing. |
result.filedReturns[0].returnPeriod | String | The return period. |
result.filedReturns[0].returnType | String | The type we are returning. |
result.filedReturns[0].applicationReferenceNumber | String | The application reference number. |
result.filedReturns[0].status | String | The status of the return. |
{
"result": {
"filedReturns": [
{
"valid": "Yes",
"methodOfFilling": "ONLINE",
"dateOfFilling": "20/03/2018",
"returnPeriod": "02/2018",
"returnType": "GSTR3B",
"applicationReferenceNumber": "<Reference number>",
"status": "Filed"
},
{
"valid": "Yes",
"methodOfFilling": "ONLINE",
"dateOfFilling": "22/02/2018",
"returnPeriod": "01/2018",
"returnType": "GSTR3B",
"applicationReferenceNumber": "<Reference number>",
"status": "Filed"
},
{
"valid": "Yes",
"methodOfFilling": "ONLINE",
"dateOfFilling": "02/02/2018",
"returnPeriod": "12/2017",
"returnType": "GSTR1",
"applicationReferenceNumber": "<Reference number>",
"status": "Filed"
},
{
"valid": "Yes",
"methodOfFilling": "ONLINE",
"dateOfFilling": "17/01/2018",
"returnPeriod": "12/2017",
"returnType": "GSTR3B",
"applicationReferenceNumber": "<Reference number>",
"status": "Filed"
},
{
"valid": "Yes",
"methodOfFilling": "ONLINE",
"dateOfFilling": "25/12/2017",
"returnPeriod": "09/2017",
"returnType": "GSTR1",
"applicationReferenceNumber": "<Reference number>",
"status": "Filed"
},
{
"valid": "Yes",
"methodOfFilling": "ONLINE",
"dateOfFilling": "19/12/2017",
"returnPeriod": "11/2017",
"returnType": "GSTR3B",
"applicationReferenceNumber": "<Reference number>",
"status": "Filed"
},
{
"valid": "Yes",
"methodOfFilling": "ONLINE",
"dateOfFilling": "15/11/2017",
"returnPeriod": "10/2017",
"returnType": "GSTR3B",
"applicationReferenceNumber": "<Reference number>",
"status": "Filed"
},
{
"valid": "Yes",
"methodOfFilling": "ONLINE",
"dateOfFilling": "16/10/2017",
"returnPeriod": "09/2017",
"returnType": "GSTR3B",
"applicationReferenceNumber": "<Reference number>",
"status": "Filed"
},
{
"valid": "Yes",
"methodOfFilling": "ONLINE",
"dateOfFilling": "23/09/2017",
"returnPeriod": "07/2017",
"returnType": "GSTR1",
"applicationReferenceNumber": "<Reference number>",
"status": "Filed"
},
{
"valid": "Yes",
"methodOfFilling": "ONLINE",
"dateOfFilling": "19/09/2017",
"returnPeriod": "08/2017",
"returnType": "GSTR3B",
"applicationReferenceNumber": "<Reference number>",
"status": "Filed"
},
{
"valid": "Yes",
"methodOfFilling": "ONLINE",
"dateOfFilling": "22/08/2017",
"returnPeriod": "07/2017",
"returnType": "GSTR3B",
"applicationReferenceNumber": "<Reference number>",
"status": "Filed"
}
]
}
}Contact Us for Any Assistance
If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.
We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!