ITR OTP Get ITR Pull
This API allows patrons to request income tax returns filing(ITRs) for their users. This can be done by either authorizing with the OTP or the Password depending on the support provided by the PAN. The response will contain the required ITRs in the specified format.
This endpoint is used to retrieve the ITR details
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].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].ITR | Object | A nested structure containing details of the ITR form. |
result.[assessment-year].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. |
CODE | MESSAGE |
200 | Request successful |
409 | Upstream is down |
400 | Bad Request - Mandatory parameters missing or incorrent request ID |