ITR Pull
Introduction
This API allows patrons to request income tax returns filing(ITRs) for their users by providing essential details such as the pan and password for past 3 years. The response will contain the required ITRs in the specified format.
Sample curl
curl --location 'https://api.signzy.app/api/v3/itr/itr-pull' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: <Auth Token>' \
--data-raw '{
"username": "*******",
"password": "*********",
"sessionId": "*********"
}'Input Parameters
Parameter | Type | Description |
|---|---|---|
username | string | The username of the end-customer on the ITR Portal. It usually is the PAN of the user. |
password | string | Password for the ITR portal of the PAN holder |
sessionId | string | Any previous session Id can be passed instead of password |
Note: Exactly one of password or sessionId must be passed.
Note 2: ITR services may get impacted during ITR filling season.
Sample Response
{
"username" : "*****",
"password" : "*****",
"id": 1,
"result": {
"2022-23": {
"form": "https://persist.signzy.tech/api/files/558693763/download/9185b3b5dfb34a0291a29c27dfa761cace8b33ecce464511bb0cb391333d254e.pdf",
"json": {
"ITR": {
"ITR1": {
"CreationInfo": {},
"Form_ITR1": {},
"PersonalInfo": {},
"FilingStatus": {},
"ITR1_IncomeDeductions": {},
"ITR1_TaxComputation": {},
"TaxPaid": {},
"Refund": {},
"Schedule80G": {},
"Schedule80GGA": {},
"Schedule80D": {},
"TDSonSalaries": {},
"TDSonOthThanSals": {},
"ScheduleTDS3Dtls": {},
"ScheduleTCS": {},
"TaxPayments": {},
"Verification": {},
"TaxReturnPreparer": null
}
}
}
},
"2021-22": {
"form": "https://persist.signzy.tech/api/files/558694037/download/de970c13de9a46fd9de64c623de46829afb0745d5d5243fd923f1ba8d0c83c68.pdf",
"json": {
"ITR": {
"ITR3": {
"CreationInfo": {},
"Form_ITR3": {},
"PartA_GEN1": {},
"PartA_GEN2": {},
"PARTA_BS": {},
"ManufacturingAccount": {},
"TradingAccount": {},
"PARTA_PL": {},
"PARTA_OI": {},
"ScheduleS": {},
"ScheduleHP": {},
"ITR3ScheduleBP": {},
"ScheduleCGFor23": {},
"Schedule112A": {},
"ScheduleOS": {},
"ScheduleCYLA": {},
"ScheduleBFLA": {},
"ScheduleCFL": {},
"ITR3ScheduleUD": {},
"ScheduleICDS": {},
"Schedule80D": {},
"Schedule80_IA": {},
"Schedule80_IB": {},
"Schedule80_IC": {},
"ScheduleVIA": {},
"ScheduleAMT": {},
"ScheduleAMTC": {},
"ScheduleSI": {},
"ScheduleTR1": {},
"PartB-TI": {},
"PartB_TTI": {},
"ScheduleIT": {},
"ScheduleTDS1": {},
"ScheduleTDS2": {},
"ScheduleTDS3": {},
"ScheduleTCS": {},
"Verification": {},
"PARTA_QD": null,
"ScheduleDPM": null,
"ScheduleDOA": null,
"ScheduleDEP": null,
"ScheduleDCG": null,
"ScheduleESR": null,
"Schedule115AD": null,
"ScheduleVDA": null,
"Schedule10AA": null,
"Schedule80G": null,
"Schedule80GGA": null,
"Schedule80RA": null,
"ScheduleSPI": null,
"ScheduleIF": null,
"ScheduleEI": null,
"SchedulePTI": null,
"ScheduleTPSA": null,
"ScheduleFSI": null,
"ScheduleFA": null,
"Schedule5A2014": null,
"ScheduleAL": null,
"ScheduleGST": null,
"TaxReturnPreparer": null,
"ScheduleESOP": null
}
}
}
},
"2020-21": {
"form": "https://persist.signzy.tech/api/files/558694095/download/2d389c6b003b4167a344cdc43cd638a2db4cd9234bc34f22a99ed09ba89d031f.pdf",
"json": {
"ITR": {
"ITR1": {
"CreationInfo": {},
"Form_ITR1": {},
"PersonalInfo": {},
"FilingStatus": {},
"ITR1_IncomeDeductions": {},
"ITR1_TaxComputation": {},
"TaxPaid": {},
"Refund": {},
"ScheduleDI": null,
"Schedule80D": {},
"Verification": {},
"Schedule80G": null,
"Schedule80GGA": null,
"TDSonSalaries": null,
"TDSonOthThanSals": null,
"ScheduleTDS3Dtls": null,
"ScheduleTCS": null,
"TaxPayments": null,
"TaxReturnPreparer": null
}
}
}
}
}
}Output Parameters
Parameter | Type | Description |
|---|---|---|
username | string | The username provided in the input |
password | string | The password provided in the input |
id | number | Unique ID to identify the request |
result | object | Entire result |
result.[assessment-year] | object | ITR for given assessment year. eg. result[2022-23] |
result.[assessment-year].ITR | object | JSON object of ITR |
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. |
ITR Schemas
Signzy provided standard JSON schemas provided by the ITR portal. For a detailed list, one can refer to: https://www.incometax.gov.in/iec/foportal/downloads/income-tax-returns to check the latest schema being given by the ITR portal.

Note : ITR services may get impacted during ITR filling season.
Status codes
CODE | MESSAGE |
|---|---|
200 | Request successful |
409 | Upstream is down |
Getting help
Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.
You can reach out to us at [email protected].