DISCREPANCY

3 min

Introduction

This API allows you to submit GST returns and detect discrepancies in your filings. Using the provided parameters, you can send data to the server via a POST request to the specified URL, and receive responses in JSON format. The API requires an access token for authorization.

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

Parameter Name	Data Type	Required	Description
url	string	Yes	The endpoint URL for the API request.
Accept	string	No	The acceptable response media type.
Accept-Language	string	No	The preferred language for the response.
Authorization	string	Yes	The access token required for authorization.
content-type	string	Yes	The media type of the request body.
gstin	string	Yes	The GSTIN number of the user.
username	string	Yes	The username associated with the account.
sek	string	Yes	The shared encryption key for the user.
appKey	string	Yes	The application key associated with the account.
authToken	string	Yes	The authentication token required for the API call.
retPeriod	string	Yes	The return period for the GST filing.

Sample Response

{
    "essentials": {
        "gstin": "..gstin..",
        "username": "..username..",
        "authToken": "..authToken..",
        "appKey": "..appKey..",
        "sek": "..sek..",
        "retPeriod": "..retPeriod.."
    },
    "id": "...accessToken...",
    "patronId": "...patronId...",
    "result":{
        "sale" : {
            "status" : "..status..",
            "gstr1Amount" : "..gstr1Amount..",
            "gstr3bAmount" : "..gstr3bAmount.."
        },
        "purchase" : {
            "status" : "..status..",
            "gstr2aAmount" : "..gstr2aAmount..",
            "gstr3bAmount" : "..gstr3bAmount.."
        }

        }
      }

Parameter Name	Data Type	Required	Description
essentials	object	Yes	The essential details required for the API call.
gstin	string	Yes	The GSTIN number of the user.
username	string	Yes	The username associated with the account.
authToken	string	Yes	The authentication token is required for the API call.
appKey	string	Yes	The application key is associated with the account.
sek	string	Yes	The shared encryption key for the user.
retPeriod	string	Yes	The return period for the GST filing.
id	string	Yes	The access token generated for the API call.
patronId	string	Yes	The patron ID for the user.
result	object	Yes	The resulting object contains the sale and purchase details.
sale	object	Yes	The details related to sales.
status	string	Yes	The status of the GST filing for sales.
gstr1Amount	string	Yes	The amount for GSTR1 for sales.
gstr3bAmount	string	Yes	The amount for GSTR3B for sales.
purchase	object	Yes	The details related to purchases.
status	string	Yes	The status of the GST filing for purchases.
gstr2aAmount	string	Yes	The amount for GSTR2A for purchases.
gstr3bAmount	string	Yes	The amount for GSTR3B for purchases.