ITR OTP Get ITR V
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.
This endpoint is used to retrieve the ITR receipt in PDF format based on the provided requestId.
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 |
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" |
CODE | MESSAGE |
200 | Request successful |
409 | Upstream is down |
400 | Bad Request - Mandatory parameters missing or incorrent request ID |