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].