Entity Delinquency Request

4 min

Introduction

The GSTR Delinquencies API is a web service that calculates the interest, late fee, and penalty amounts for late or missed filings of GST returns, using the specified GSTIN and return period. The API can be used by GST service providers, tax consultants, and other organizations to determine the delinquency amounts and take necessary actions to rectify the non-compliance with GST regulations.

Sample cURL

curl --location --request POST 'http://signzy.tech/api/v2/patrons/..your-patron-id../gstrdelinquencies' \
--header 'Accept: */*' \
--header 'Accept-Language: en-US,en;q=0.8' \
--header 'Authorization: <Access-Token>' \
--header 'content-type: application/json' \
--data-raw '{
    "essentials": {
        "gstin": "...gstin...",
        "username": "...username...",
        "sek": "...sek...",
        "appKey": "...appKey...",
        "authToken": "...authToken...",
        "retPeriod": "...retPeriod..."
    }
}'

Parameter Name	Description	Example Value
patron-id	ID of the patron in the Signzy system	abcdefg
Access-Token	Authentication token to authorize the request	eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9eyJzdWIiOiIxMjM0N
gstin	Goods and Services Tax Identification Number	29ABCDE1234F1Z5
username	Username for the Signzy system	john_doe
sek	Signzy Encryption Key	XYZ123
appKey	Application key for the Signzy system	abcdefg
authToken	Authentication token to access the Signzy system	eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9eyJzdWIiOiIxMjM0N
retPeriod	Return period for the GSTR Delinquencies API, specifying the year and month in MM-YYYY format	03-2023

Sample Response

{
    "id": "...accessToken...",
    "patronId": "...patronId...",
    "result":{
        "interest" : "..interest..",
        "lateFee" : "..lateFee..",
        "penalty" : "..penalty..",
        "status" : "..status..."
    }
}

Parameter Name	Description	Example Value
id	Access token for the GSTR Delinquencies API request	abcdefg
patronId	ID of the patron in the Signzy system	123456
interest	Total interest amount calculated for the delinquency	500.00
lateFee	Total late fee amount calculated for the delinquency	250.00
penalty	Total penalty amount calculated for the delinquency	150.00
status	Status of the GSTR Delinquencies API request	SUCCESS or FAILURE