ITR OTP Get ITR V

Introduction:

This API facilitates patrons in obtaining Income Tax Return (ITR) receipts in PDF format by providing essential details such as PAN (Permanent Account Number) and passwords for the past three years. It is designed to efficiently retrieve the necessary information, catering to the needs of patrons who require both formats for their users.

POST /itr/get-itr-v

This endpoint is used to retrieve the ITR receipt in PDF format based on the provided requestId.

Sample Curl:

curl --location 'https://api-preproduction.signzy.app/api/v3/itr/get-itr-v' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: <Auth Token>' \
--data-raw '{
    "requestId": output of the requestId
}'

Input Parameters:

Parameter	Type	Description	Mandatory/Optional
requestId	string	A unique identifier (UUID) is generated by the requestId API. The requestId serves as a reference for the initiated request and can be used for fetching the corresponding ITR details.	Mandatory
range	number	The number of years for which the data must be given for. Minimum is 1 and maximum is 3. Default is 3	Optional

Sample Response:

{
  "requestId": "7deb646e-9892-419a-96dc-7cd6260507bc",
  "panNumber": "DUMMY1234A",
  "result": {
    "2022-2023": [
      {
        "panNumber": "DUMMY1234A",
        "filingYear": "2022-2023",
        "acknowledgementNumber": "462158851291023",
        "filingType": "Original",
        "itrVbase64": "rO0ABXVyABNbTGphdmEubGFuZy5PYmplY3Q7kM5YnxBzKWwCAAB4cAAAAAJzcgARamF2YS51dGlsLkhhc2hNYXAFB9rBwxZg0QMAAkYACmxvYWRGYWN0b3JJAAl0aHJlc2hvbGR4cD9AAAAAAAAMdwgAAAAQAAAAA3QAEVRyYW5zZmVyLUVuY29kaW5ndAAHY2h1bmtlZHQABERhdGV0AB1XZWQsIDI0IEp1biAyMDI2IDA5OjI4OjMzIEdNVHQADENvbnRlbnQtVHlwZXQAD2FwcGxpY2F0aW9uL3BkZnh1cgACW0Ks8xf4BghU4AIAAHhwAAD6JiVQREYtMS40CjEgMCBvYmoKPDwKL1RpdGxlIC"
        "itrVPdf": "https://persist.signzy.tech/api/files/812770777/download/sample.pdf"
      }
    ]
  },
  "message": "1 year ITR Data available in the last 3 year(s)",
  "statusCode": 200
}

Output Parameters:

Parameter	Type	Description
requestId	string	requestId given in the input to fetch ITR Form
panNumber	string	The PAN (Permanent Account Number) is associated with an individual or entity.
result	object	Entire result
result.[assessment-year]	object	ITR for a given assessment year. eg. result[2022-23]
result.[assessment-year].panNumber	string	The PAN (Permanent Account Number) is associated with an individual or entity.
result.[assessment-year].filingYear	string	The fiscal year for which the filing is being done is specified in the format "YYYY-YYYY."
result[assessment-year].acknowledgementNumber	string	The acknowledgment number is associated with the filed return.
result[assessment-year].filingType	string	The type of filing indicates whether it is an original filing.
result[assessment-year].itrVPdf	string (URL)	The URL to the PDF file of the filed ITR receipt. If unable to get the PDF from source then it will contain a string "Upstream is down"
result[assessment-year].itrVbase64	string	The base64 string of URL to the PDF file of the filed ITR receipt. If unable to get the PDF from source then it will be empty string

Status Codes:

CODE	MESSAGE
200	Request successful
409	Upstream is down
400	Bad Request - Mandatory parameters missing or incorrent request ID