ITR

Fetch Income Tax Return

This API allows you to fetch the Income Tax Return of a client for a given financial year in JSON, PDF, or XML formats.

A user must be added as a client before calling the Fetch ITR API

post
Fetch ITR request

https://api.sandbox.co.in/itd/eri/tax-payers/:pan/itrs/:assessment_year
Initiate Fetch ITR request for a given assessment year
Request
Response
Request
Path Parameters
pan
required
string
assessment_year
required
string
Headers
Authorization
required
string
JWT Authorization token
x-api-key
required
string
Public key required to authorize API access.
x-api-version
required
string
Response
200: OK
{
"transaction_id": "85dcf64b-217b-4b28-afdb-d99c9d5452b1",
"status": "JOBQUEUED"
}

get
Get ITR

https://api.sandbox.co.in/itd/eri/tax-payers/:pan/itrs/:assessment_year?transaction_id={transaction_id}
Obtain the ITR of the client in JSON, PDF, or XML format
Request
Response
Request
Path Parameters
assessment_year
required
string
pan
required
string
Headers
accept
required
string
possible values: application/json, application/xml, application/pdf
Authorization
required
string
JWT Authorization token
x-api-key
required
string
Public key required to authorize API access.
x-api-version
required
string
Query Parameters
transaction_id
required
string
Response
200: OK
JOBDONE (JSON)
JOBDONE (XML)
JOBDONE (PDF)
JOBQUEUED
JOBFAILED
JOBDONE (JSON)
{
"transaction_id": "85dcf64b-217b-4b28-afdb-d99c9d5452b1",
"status": "JOBDONE",
"data": {
"ns3:ITR": {
"xmlns": "http://incometaxindiaefiling.gov.in/master",
"ns2:ITR1": {
"CreationInfo": {
"XMLCreationDate": "2020-08-22",
"IntermediaryCity": "Ahmedabad",
"Digest": "izUrqWs+GH6tADkd10Iv6/QNyG5lsKeM4IONteGxk8o=",
"SWVersionNo": "2019.0.0",
"SWCreatedBy": "SW10002146",
"XMLCreatedBy": "SW10002146"
},
"Schedule80D": {
"Sec80DSelfFamSrCtznHealth": {
"ParentsSeniorCitizenFlag": "P",
"SeniorCitizenFlag": "S",
"EligibleAmountOfDedn": 0
}
},
"ITR1_IncomeDeductions": {
"GrossSalary": 0,
"TotalIncomeOfHP": 0,
"AllwncExemptUs10": {
"TotalAllwncExemptUs10": 0
},
"NetSalary": 0,
"ExemptIncAgriOthUs10": {
"ExemptIncAgriOthUs10Total": 0
},
"GrossTotIncome": 0,
"UsrDeductUndChapVIA": {
"Section80DD": 0,
"Section80EE": 0,
"Section80GG": 0,
"Section80EEA": 0,
"Section80GGA": 0,
"Section80TTA": 0,
"Section80DDB": 0,
"Section80EEB": 0,
"Section80TTB": 0,
"Section80CCC": 0,
"Section80GGC": 0,
"Section80U": 0,
"Section80CCDEmployer": 0,
"TotalChapVIADeductions": 0,
"Section80C": 0,
"Section80D": 0,
"Section80CCD1B": 0,
"Section80G": 0,
"Section80E": 0,
"Section80CCDEmployeeOrSE": 0
},
"IncomeFromSal": 0,
"TotalIncome": 0,
"DepPayInvClmUndDednVIA": "N",
"DeductionUs16": 0,
"OthersInc": "",
"IncomeOthSrc": 0,
"DeductUndChapVIA": {
"Section80DD": 0,
"Section80EE": 0,
"Section80GG": 0,
"Section80EEA": 0,
"Section80GGA": 0,
"Section80TTA": 0,
"Section80DDB": 0,
"Section80EEB": 0,
"Section80TTB": 0,
"Section80CCC": 0,
"Section80GGC": 0,
"Section80U": 0,
"Section80CCDEmployer": 0,
"TotalChapVIADeductions": 0,
"Section80C": 0,
"Section80D": 0,
"Section80CCD1B": 0,
"Section80G": 0,
"Section80E": 0,
"Section80CCDEmployeeOrSE": 0
}
},
"Refund": {
"BankAccountDtls": {
"AddtnlBankDetails": {
"BankName": "HDFC Bank",
"IFSCCode": "HDFC0001707",
"UseForRefund": true,
"BankAccountNo": 123456789
}
},
"RefundDue": 0
},
"PersonalInfo": {
"EmployerCategory": "NA",
"Address": {
"MobileNo": 9909237005,
"StateCode": 11,
"CountryCode": 91,
"LocalityOrArea": "Vastrapur",
"ResidenceNo": "B 701 Amrapali Lakeview tower",
"CityOrTownOrDistrict": "Ahmedabad",
"EmailAddress": "[email protected]",
"PinCode": 380015,
"CountryCodeMobile": 91
},
"DOB": "1997-01-01",
"AadhaarCardNo": 123456789000,
"AssesseeName": {
"SurNameOrOrgName": "Doe",
"FirstName": "John"
},
"PAN": "XXXPD1234A"
},
"TaxPaid": {
"BalTaxPayable": 0,
"TaxesPaid": {
"TDS": 0,
"TCS": 0,
"AdvanceTax": 0,
"SelfAssessmentTax": 0,
"TotalTaxesPaid": 0
}
},
"FilingStatus": {
"IncrExpAggAmt1LkElctrctyPrYrFlg": "N",
"IncrExpAggAmt2LkTrvFrgnCntryFlg": "N",
"SeventhProvisio139": "N",
"DepAmtAggAmtExcd1CrPrYrFlg": "N",
"ReturnFileSec": 11
},
"Form_ITR1": {
"SchemaVer": "Ver1.0",
"Description": "For Indls having Income from Salary, Pension, family pension and Interest",
"FormVer": "Ver1.0",
"AssessmentYear": 2020,
"FormName": "ITR-1"
},
"ITR1_TaxComputation": {
"TotTaxPlusIntrstPay": 0,
"Rebate87A": 0,
"TotalIntrstPay": 0,
"EducationCess": 0,
"TaxPayableOnRebate": 0,
"GrossTaxLiability": 0,
"NetTaxLiability": 0,
"Section89": 0,
"TotalTaxPayable": 0,
"IntrstPay": {
"IntrstPayUs234C": 0,
"IntrstPayUs234A": 0,
"LateFilingFee234F": 0,
"IntrstPayUs234B": 0
}
},
"Verification": {
"Capacity": "S",
"Declaration": {
"AssesseeVerName": "John Doe",
"AssesseeVerPAN": "XXXPD1234A",
"FatherName": "Jake"
},
"Place": "Ahmedabad"
}
},
"xmlns:ns2": "http://incometaxindiaefiling.gov.in/ITR1",
"xsi:schemaLocation": "http://incometaxindiaefiling.gov.in/main",
"xmlns:ns3": "http://incometaxindiaefiling.gov.in/main",
"xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance"
}
}
}
JOBDONE (XML)
{
"transaction_id": "85dcf64b-217b-4b28-afdb-d99c9d5452b1",
"status": "JOBDONE",
"data": {
"signed_url": "https://..."
}
}
JOBDONE (PDF)
{
"transaction_id": "85dcf64b-217b-4b28-afdb-d99c9d5452b1",
"status": "JOBDONE",
"data": {
"signed_url": "https://..."
}
}
JOBQUEUED
{
"transaction_id": "85dcf64b-217b-4b28-afdb-d99c9d5452b1",
"status": "JOBQUEUED",
}
JOBFAILED
{
"transaction_id": "85dcf64b-217b-4b28-afdb-d99c9d5452b1",
"status": "JOBFAILED",
}