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/returns

POST https://api-preproduction.signzy.app/api/v3/gst/returns

Request 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!