ITR Form 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. One distinctive feature of this API is the utilization of a callback mechanism. When patrons initiate a request using the GET /get-request-id endpoint, they can include a callback_url parameter. This parameter represents a URL where the API will send a POST request upon completion of the request processing.
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 get-request-id API. The requestId serves as a reference for the initiated request and can be used for fetching the corresponding ITR form. | Mandatory |
Parameter | Type | Description |
requestId | string | requestId given in the input to fetch ITR Form |
clientId | string | This clientId helps in tracking and managing requests associated with a specific client or application. |
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].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].formPdf | string (URL) | The URL to the PDF file of the filed ITR form. Or "Upstream is down" if there are technical issues at ITR |
CODE | MESSAGE |
200 | Request successful |
409 | Upstream is down |
422 | Unauthorized - Wrong user ID or password, cannot login |
400 | Bad Request - Mandatory parameters missing |