ITR OTP Get ITR Form
This API facilitates patrons in obtaining Income Tax Return (ITR) forms in JSON and PDF formats 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 form in JSON and 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 form. | 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].filingDate | string | Date of filing the ITR |
result.[assessment-year].filedBy | string | Who has filed the ITR |
result.[assessment-year].filingSection | string | The Filing Section of the ITR |
result.[assessment-year].itrType | string | The type of ITR filed |
result.[assessment-year].itrFilingStatus | Array | Array of objects containing two keys : statusDescription and activityDate This is a list of Statuses of ITR filing |
result.[assessment-year].itrFilingStatus[status].statusDescription | string | The status description |
result.[assessment-year].itrFilingStatus[status].activityDate | string | The date of the activity of the corresponding status |
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].json | Object | A nested structure containing details of the ITR form. |
result.[assessment-year].json.ITR.ITRn | Object | Contains the ITR object. It can be any one of ITR1, ITR2, ITR3, ITR4, ITR5, ITR6, ITR7. The "n" is the number from 1 to 7 which can be present like ITR1, ITR2 etc. |
result[assessment-year].form | string (URL) | The URL to the PDF file of the filed ITR form. 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 |