ITR Analytics V3
Introduction:
ITR is one of the most important structured data sources that can help in understanding the financial background of an individual/corporate. This data can then be cross-referenced with other sources like Bank Statements, GST, MCA data if available, or Declared information like Employment details and Salary to have a more comprehensive picture of the customer. The important usecase of this data is Lending of any sort but it can also be used for onboarding and account openings for corporates in some cases Our API seamlessly integrates the financial data retrieval process, starting with users initiating the generation of a unique reference ID by providing essential credentials. This reference ID serves as the key for users to request comprehensive Income Tax Return (ITR) analytics, including ITR details, tax information, balance sheets, profit and loss statements, and ratio analysis. The API efficiently responds with a downloadable Excel file, enabling users to conduct in-depth analyses and make well-informed financial decisions based on the wealth of detailed analytics data provided.
Endpoints:
This API consists of two main endpoints:
- /itr-analytics/get-reference-id
- /itr-analytics/get-analytics
POST /itr-analytics/get-reference-id
This API generates a reference ID for a given user using their essentials such as username and password.
Sample Curl:
curl --location 'https://api-preproduction.signzy.app/api/v3/itr-analytics/get-reference-id' \
--header 'Content-Type: application/json' \
--header 'Authorization: <access-token>' \
--data-raw '{
"username": "ABCDE1234F",
"password": "ABCD@12345"
}'Input Parameters:
Parameter | Type | Description | Mandatory/Optional |
|---|---|---|---|
username | string | The username of the end-customer on the ITR Portal. It usually is the PAN of the user. | Mandatory |
password | string | Password for the ITR portal of the PAN holder | Mandatory |
Sample Response:
{
"status": 200,
"message": "SUCCESS",
"result": {
"referenceId": "5b54205e-1738-4a99-bfad-d85a205fd34z",
"statusMessage": "Successfully Submitted."
}
}Output Parameters:
Parameter | Type | Description |
|---|---|---|
result | Object | Result object containing the referenceId |
result[referenceId] | string | Generated reference ID.x |
result[statusMessage] | string | Status message indicating the success/failure of the operation. |
Sample data for getting ITR-1 to ITR-4 response
username | password |
|---|---|
ABCDE1234F | ITR1 |
EACBD2143F | ITR2 |
BDCAE4312F | ITR3 |
CDEBA1342F | ITR4 |
POST /itr-analytics/get-analytics
This API retrieves analytics data related to Income Tax Returns (ITR) for a given user using their reference ID.
Sample Curl:
curl --location 'https://api-preproduction.signzy.app/api/v3/itr-analytics/get-analytics' \
--header 'Content-Type: application/json' \
--header 'Authorization: <access-token>' \
--data '{
"referenceId": "5b54205e-1738-4a99-bfad-d85a205fd34z"
}'Input Parameters:
Parameter | Type | Description | Mandatory/Optional |
|---|---|---|---|
referenceId | string | Reference ID obtained from the `get-reference-id` API. | Mandatory |
Sample Response:
{
"status": 200,
"message": "SUCCESS",
"result": {
"excelUrl": "https://staging-persist.signzy.tech/api/files/5011013/download/4a6bfebe4dfe4447971d131163c9ac08a9db5b8a89054d569ac7f29c72839400.xlsx",
"data": {
"iTR": {
"generalInformation": {
"generalInformation": [
{
"year": 2021,
"iTRType": "ITR-1",
"originalOrRevised": "Original",
"acknowledgementNumber": "420415710020921",
"name": "John Doe",
"oldName(IfApplicable)": "",
"dateOfBirth": "1990-01-01",
"father'SName": "John Doe Sr.",
"natureOfEmployment(GovtPSUOtherPensionersNA)": "OTH",
"aadharNumberAadharEnrollmentNumber": "123456789012",
"pAN": "ABCDE1234F",
"registeredAddress": "123 Main St, Cityville, State, Country, 123456",
"emailId": "[email protected]",
"contactNumber": "1234567890",
"numberOfHouseProperties": "0",
"residentialStatus(ResidentNon-Resident)": "Resident",
"countryOfResidence(InCaseOfNRI)": "",
"taxpayerIdentificationNumberOfTheCountry": "",
"originalReturnFilingDate": "2021-09-02",
"revisedReturnFilingDate": "",
"status(IndividualHUFPublicPrivateFirmLocalAuthorityAOPBOIAJP)": "Individual",
"dateOfIncorporation": "",
"dateOfCommencementOfBusiness": "",
"cINLLPIN": "",
"isCompanyFirmDomestic?(YN)": "",
"holdingStatus(HoldingSubsidiaryBothAnyOther)": "",
"whetherTheCompanyIsAFIIFPI?,IfYes,SEBIRegistrationNumber": "",
"whetherTheCompanyIsRecognizedAsStartupByDPIIT?,IfYes,ProvideTheRegistrationNumber": "",
"whetherTheCompanyIsAPSU?(YN)": "",
"whetherTheCompanyIsOwnedByRBI?(YN)": "",
"whetherAnyGovernmentEntityHasShareholdingOf40%OrAbove?(YN)": "",
"companyType(BankingScheduledInsuranceNBFC)": "",
"whetherTheCompanyIsUnlisted?(YN)": ""
}
],
"natureOfBusinessProfession": [
{
"year": "",
"code-SubSector": "",
"tradeNameOfBusiness,IfAny": ""
}
],
"grossReceiptReportedForGST": [
{
"year": "",
"gSTIN": "",
"annualValueOfOutwardSupplies": ""
}
],
"informationOfAllBankAccounts": [
{
"year": 2021,
"accountNumber": "2913610116",
"nameOfTheBank": "Kotak Bank",
"iFSCode": "KKBK0000672"
}
],
"detailsOfKeyPersons": [
{
"year": "",
"name": "",
"dIN": "",
"designation": "",
"pAN": "",
"address": ""
}
],
"detailsOfTheHoldingCompanies": [
{
"year": "",
"name": "",
"address": "",
"pAN": "",
"percentageOfShares": ""
}
],
"detailsOfChangeOfPartnersMembers": [
{
"year": "",
"name": "",
"dateOfAdmissionRetirement": "",
"natureOfChange(AdmittedRetired)": "",
"percentageOfShares": ""
}
],
"shareHoldersInformation": [
{
"year": "",
"name": "",
"designation": "",
"pAN": "",
"percentageOfShares": "",
"address": ""
}
],
"otherFirmsInWhichTheEntityIsAPartner": [
{
"year": "",
"name": "",
"pAN": "",
"%ShareInTheProfitOfTheFirm": ""
}
]
},
"taxDetails": {
"informationInCaseOfADirector": [
{
"year": "",
"dIN": "",
"nameOfCompany": "",
"typeOfCompany": "",
"pANOfCompany": "",
"whetherTheSharesAreListed": ""
}
],
"informationInCaseOfAPartner": [
{
"year": "",
"nameOfTheFirm": "",
"pANOfTheFirm": ""
}
],
"informationAboutAuditor": [
{
"year": "",
"nameOfAuditor": "",
"nameOfTheAuditor'SFirm": "",
"membershipNoOfAuditor": ""
}
],
"informationAboutTheEmployer": [
{
"year": 2022,
"name": "ABC Enterprises",
"address": "Cityville, State, Country, 123456",
"tANPAN": ""
}
],
"incomeFromSalary": [
{
"year": 2021,
"grossSalary": 246000,
"netSalaryAfterExemptions": 246000,
"totalDeductionsAvailedUnderSection16": 50000,
"taxableIncomeFromSalary": 196000
}
],
"informationOfHouseProperty": [
{
"year": "",
"addressOfProperty": "",
"typeOfHouseProperty": "",
"isPropertyCo-Owned,IfYes,PercentageOfOwnership": "",
"pANOfCo-Owner": "",
"pANOfTenant(IfLetOut)": ""
}
],
"detailsOfTaxAssessment": {
"incomeFromHouseProperty": [
{
"year": 2021,
"incomeFromHouseProperty": "",
"annualValueOfPropertyOwned(A)": "",
"30%Of(A)(B)": "",
"interestPayableOnBorrowedCapital(C)": "",
"passThroughIncome(D)": "",
"arrearsUnrealizedRentReceivedDuringTheYearLess30%(E)": ""
}
],
"profitsAndGainsFromBusinessOrProfession": [
{
"year": 2021,
"profitsAndGainsFromBusinessOrProfession": "",
"profitFromBusinessOtherThanSpeculativeBusinessAndSpecifiedBusiness": "",
"profitFromSpeculativeBusiness": "",
"profitFromSpecifiedBusiness": "",
"incomeChargeableToTaxAtSpecialRatesUnderSection115BBFAnd115BBG": "",
"profitFromLifeInsuranceBusinessUnderSection115B": "",
"incomeFromFirmsOfWhichPartner": ""
}
],
"presumptiveIncomeFromProfessionsUnderSection44AD": [
{
"year": 2021,
"presumptiveIncomeFromProfessionsUnderSection44AD": "",
"grossReceiptThroughAccountPayeeChequeBankDraftECS(A)": "",
"grossReceiptThroughAnyOtherMode(B)": "",
"higherOf6%Of(A)OrAmountClaimedToHaveBeenEarned": "",
"higherOf8%Of(B)OrAmountClaimedToHaveBeenEarned": ""
}
],
"presumptiveIncomeFromProfessionsUnderSection44ADA": [
{
"year": 2021,
"presumptiveIncomeFromProfessionsUnderSection44ADA": "",
"grossReceipts": "",
"presumptiveIncomeUnderSection44ADA(50%OfGrossReceipts)": ""
}
],
"presumptiveIncomeFromGoodsCarriagesUnderSection44AE": [
{
"year": 2021,
"presumptiveIncomeFromGoodsCarriagesUnderSection44AE": "",
"presumptiveIncomeFromGoodsCarriage(A)": "",
"salaryAndInterestPaidToThePartners(B)": "",
"presumptiveIncomeUnderSection44AE(C)": ""
}
],
"informationAndIncomeFromInvestments": {
"shortTermCapitalGains": [
{
"year": 2021,
"shortTermGainsOnImmovableProperty": "",
"shortTermGainsFromSlumpSale": "",
"shortTermGainsOnEquitySharesOrEquityOrientedMF": "",
"forAnNRIButNotFII,ShortTermGainsOnSaleOfSharesOrDebenturesOfAnIndianCompany": "",
"forAnNRIAndFII,ShortTermGainsOnSaleOfSecurities": "",
"shortTermGainsOnOtherAssets": ""
}
],
"longTermCapitalGains": [
{
"year": 2021,
"longTermGainsOnImmovableProperty": "",
"longTermGainsFromSlumpSale": "",
"longTermGainsOnBondsOrDebentures": "",
"longTermGainsFromSaleOfListedSecurities": "",
"longTermGainsOnEquitySharesOrEquityOrientedFunds": "",
"forAnNRI,LongTermGainsOnSaleOfSharesOrDebenturesOfAnIndianCompany": "",
"forAnNRI,LongTermGainsOnSaleOfUnlistedSecurities": "",
"forAnNRI,LongTermGainsOnEquitySharesOrEquityOrientedFunds": "",
"forAnNRI,LongTermGainsOnSaleOfForeignExchangeAssets": "",
"longTermGainsOnOtherAssets": ""
}
],
"incomeFromOtherSources": [
{
"year": 2021,
"incomeFromOtherSources": 21904,
"incomeFromDividends": "",
"incomeFromInterest": 92,
"rentalIncomeFromMachinery,Plants,BuildingsEtc": "",
"incomeFromImmovablePropertyWithoutConsideration": "",
"anyOtherIncome": 21812,
"incomeChargeableAtSpecialRates,Lotteries,Puzzles,OwningRaceHorsesEtc": "",
"adjustmentsUnderSection57,58And59": "",
"incomeChargeableAtNormalRates": 21904
}
]
}
}
},
"taxCalculation": {
"taxCalculation": [
{
"year": 2021,
"incomeFromSalary": 196000,
"incomeUnderHouseProperty": "",
"profitsAndGainsFromBusinessAndProfession": "",
"incomeFromShortTermCapitalGainsAsPerApplicableRates": "",
"incomeFromLongTermCapitalGainsAsPerApplicableRates": "",
"incomeFromOtherSources": 21904,
"totalOfHead-WiseIncome": 217904,
"totalLossesOfCurrentYearAndBroughtForwardLossesSetOff": "",
"grossTotalIncome": 217904,
"totalDeductionsUnderChapterVI-A": 7924,
"deductionsUnderSection10AA": "",
"incomeNotFormingPartOfTotalIncome(Section10AA,10(23FB),10(23FC))": "",
"totalTaxableIncome": 209980,
"incomeChargeableToTaxAtSpecialRates": "",
"netAgriculturalIncome": "",
"aggregateIncome": 209980,
"deemedIncomeUnderSection115JC115JB": ""
}
],
"computationOfTaxLiabilityOnTotalIncome": [
{
"year": 2021,
"totalTaxPayableOnDeemedTotalIncome": "",
"taxPayableOnTotalIncome": "",
"rebateUnderSection87a": "",
"taxPayableAfterRebate": "",
"totalSurcharge": "",
"healthAndEducationCess@4%": "",
"grossTaxLiability": "",
"grossTaxPayable": "",
"creditUnderSection115JD115JAA": "",
"taxPayableAfterCreditUnderSection115JD115JAA": "",
"reliefUnderSection89": "",
"totalTaxRelief": "",
"netTaxLiability": 0,
"totalTax,InterestAndFeePayable": "",
"aggregateLiability": "",
"totalTDS": 105,
"totalAdvanceAndSelfAssessmentTax": "",
"totalTCS": "",
"totalTaxesPaid": 105,
"amountPayable": "",
"refundIfAD>Z": 110
}
],
"taxDeductedAtSource": {
"tDSFromSalary": [
{
"year": "",
"tANOfEmployer": "",
"nameOfEmployer": "",
"tDS": ""
}
],
"tDSFromIncomeOtherThanSalary": [
{
"year": 2021,
"tANOfDeductor": "DELE04603E",
"nameOfDeductor": "EKO INDIA FINANCIAL SERVICES PVT LTD",
"pANOfOtherPerson": "",
"tDS": 105
}
],
"tDSFromHouseRentSaleOfImmovableProperty": [
{
"year": "",
"pANOfTenantBuyer": "",
"pANOfOtherPerson": "",
"tDS": "",
"nameOfTenantBuyer": ""
}
]
},
"taxCollectedAtSource": [
{
"year": "",
"taxCollectionAccountNumber": "",
"nameOfCollector": "",
"tCS": ""
}
]
},
"balanceSheet": {
"equity&Liabilities": [
{
"year": 2021,
"shareCapitalProprietor'SCapital": 500000,
"totalReservesAndSurplus": 300000,
"retainedEarnings": 150000,
"moneyReceivedAgainstShareWarrants": 0,
"shareholder'SFundsProprietor'SFunds": 950000,
"shareApplicationMoneyPendingAllotment": 0,
"longTermBorrowingsInBondsDebentures": 200000,
"longTermBorrowingsInTermLoans": 150000,
"longTermLiabilitiesFromRelatedParties": 50000,
"securedLoanFromBanksOthers": 250000,
"securedForeignCurrencyLoans": 0,
"unsecuredLoanFromBanksOthers": 100000,
"unsecuredForeignCurrencyLoans": 0,
"tradePayables(>6Months)": 120000,
"deferredTaxLiabilities": 30000,
"longTermProvisions": 25000,
"longTermLoansAndAdvances": 50000,
"otherLongTermLiabilities": 80000,
"totalNon-CurrentLiabilities": 1050000,
"loansRepayableOnDemandFromBanksOtherParties": 70000,
"shortTermLiabilitiesFromRelatedParties": 40000,
"currentMaturitiesOfLongTermDebt": 20000,
"deferredTaxLiability": 15000,
"currentTaxLiabilities": 30000,
"tradePayables(<6Months)": 80000,
"shortTermLoansAndAdvances": 40000,
"shortTermProvisions": 20000,
"otherCurrentLiabilities": 60000,
"totalCurrentLiabilities": 450000,
"totalLiabilities": 1505000,
"totalEquityAndLiabilities": 2455000
}
],
"assets": [
{
"year": 2021,
"tangibleAssets-Gross": 400000,
"intangibleAssets-Gross": 100000,
"capitalWorkInProgress": 30000,
"intangibleAssetsUnderDevelopment": 0,
"totalGrossBlock": 530000,
"depreciationAndAmortization": 100000,
"impairmentLosses": 0,
"totalFixedAssets": 430000,
"non-CurrentInvestments": 20000,
"tradeReceivables(>6Months)": 80000,
"deferredTaxAssets": 30000,
"longTermLoansAndAdvances": 25000,
"otherNon-CurrentAssets": 20000,
"totalNon-CurrentAssets": 170000,
"currentInvestments": 15000,
"inventories": 60000,
"tradeReceivables(<6Months)": 100000,
"cashAndCashEquivalents": 50000,
"shortTermLoansAndAdvances": 40000,
"currentTaxAssets": 20000,
"otherCurrentAssets": 30000,
"totalCurrentAssets": 315000,
"totalAssets": 485000,
"netWorth": 1960000
}
]
},
"profitAndLossStatement": {
"profitAndLossStatement": [
{
"year": 2021,
"saleOfGoods": 5000000,
"saleOfServices": 1200000,
"receiptsFromProfession": 800000,
"otherOperatingIncome": 50000,
"revenueFromOperations": 6260000,
"openingInventories": 1500000,
"closingInventories": 1200000,
"purchases": 3000000,
"factoryOverheads": 200000,
"directWages": 1000000,
"directExpenses": 50000,
"otherDirectCosts": 100000,
"grossProfit": 1460000,
"freightOutward": 50000,
"consumptionOfStoresAndSpareParts": 80000,
"powerAndFuel": 150000,
"employeeBenefitExpenses": 300000,
"selling,GeneralAndAdministrativeExpenses": 200000,
"selling,PromotionalAdvertisementExpenses": 100000,
"otherExpenses": 40000,
"totalExpenses": 2610000,
"eBITDA": 365000,
"depreciationAndAmortization": 50000,
"eBIT": 315000,
"financeCost": 10000,
"profitAfterInterestAndBeforeTax": 305000,
"otherNonOperatingIncome": 20000,
"otherNonOperatingExpense": 15000,
"profitBeforeTax": 310000,
"currentTax": 50000,
"deferredTax": 20000,
"profitAfterTax": 240000,
"retainedProfit": 240000
}
]
},
"ratioAnalysis": {
"liquidityAnalysis": [
{
"year": 2021,
"currentRatio": 1.8,
"cashRatio": 0.4,
"quickRatio": 1.2,
"netWorkingCapitalToTotalAssets": 0.15
}
],
"assetManagement": [
{
"year": 2021,
"inventoryTurnover": 4,
"inventoryTurnover(InDays)": 90,
"tradeReceivablesTurnoverRatio": 6,
"tradeReceivablesTurnover(InDays)": 60,
"tradePayablesTurnoverRatio": 5,
"tradePayablesTurnover(InDays)": 72,
"cashConversion(InDays)": 30,
"netWorkingCapitalTurnoverRatio": 5.5,
"fixedAssetsTurnoverRatio": 2,
"totalAssetsTurnoverRatio": 0.8
}
],
"leverageRatios": [
{
"year": 2021,
"debtRatio": 0.3,
"debtEquityRatio": 0.5,
"freeReservesEquityRatio": 1.2,
"totalOutsideLiabilityTotalNetWorth": 0.8,
"debtEBITDA": 0.1
}
],
"coverageRatios": [
{
"year": 2021,
"interestCoverageRatio": 7,
"cashInterestCoverageRatio": 8
}
],
"profitabilityRatios": [
{
"year": 2021,
"operatingProfitMargin": 5,
"netProfitMargin": 3.8,
"eBIDTAMargin": 5.8,
"returnOnAssets": 8,
"returnOnEquity": 12.5,
"grossCashAccrualMargin": 5.2,
"operatingCashflowMargin": 4,
"returnOnCapitalEmployed": 10
}
],
"growthInCashflowMargin": [
{
"year": 2021,
"growthInOperatingCashflowMargin": 6,
"growthInDebtEquity": 10,
"grossCashAccruals": 180000,
"profitAfterTaxGrowth": 12,
"salesGrowth": 8
}
]
}
}
},
"statusMessage": "Successfully Completed.",
"referenceId": "5b54205e-1738-4a99-bfad-d85a205fd34z"
}
}Output Parameters:
Parameter | Type | Description |
|---|---|---|
result | Object | Result object containing |
result[excelUrl] | string | URL to download the detailed analytics data in Excel format. |
result[data] | Object | Object containing the itr details |
result[data][iTR] | Object | Encompasses all information related to Income Tax Returns (iTR). |
result[data][iTR][generalInformation] | Object | Contains general details about the individual or entity. |
result[data][iTR][natureOfBusinessProfession] | Array | Contains general details about the individual or entity |
result[data][iTR][grossReceiptReportedForGST] | Array | Includes details about the gross receipts reported for Goods and Services Tax (GST) purposes. |
result[data][iTR][informationOfAllBankAccounts] | Array | Lists information about all bank accounts associated with the individual or entity. |
result[data][iTR][detailsOfKeyPersons] | Array | Contains details about key persons involved in the business or profession. |
result[data][iTR][detailsOfTheHoldingCompanies] | Array | Provides information about any holding companies, including names, addresses, and percentage of shares. |
result[data][iTR][detailsOfChangeOfPartnersMembers] | Array | Records changes in partners or members, including names, dates of admission or retirement, and percentage of shares. |
result[data][iTR][shareHoldersInformation] | Array | Includes information about shareholders, including names, designations, PAN numbers, and percentage of shares. |
result[data][iTR][otherFirmsInWhichTheEntityIsAPartner] | Array | Lists other firms in which the entity is a partner, along with relevant details. |
result[data][iTR][taxDetails] | Object | Contains detailed tax-related information. |
result[data][iTR][informationInCaseOfADirector] | Array | Provides details about individuals serving as directors, including company names and PAN numbers. |
result[data][iTR][informationInCaseOfAPartner] | Array | Contains information about partners, including firm names and PAN numbers. |
result[data][iTR][informationAboutAuditor] | Array | Includes details about the auditor, such as the name of the auditor and their firm, and membership number. |
result[data][iTR][informationAboutTheEmployer] | Array | Provides information about the employer, including the name and address. |
result[data][iTR][incomeFromSalary] | Array | Details the income from salary, including gross salary, deductions, and taxable income. |
result[data][iTR][informationOfHouseProperty] | Array | Contains details about owned properties, including addresses and ownership percentages. |
result[data][iTR][detailsOfTaxAssessment] | Object | Covers various aspects of tax assessment, including income from house property, business or profession, and investments. |
result[data][iTR][taxCalculation] | Object | Contains information related to the calculation of taxes. |
result[data][iTR][computationOfTaxLiabilityOnTotalIncome] | Array | Provides details on the computation of tax liability based on total income. |
result[data][iTR][taxDeductedAtSource] | Object | Includes details about tax deducted at source (TDS) from salary, income other than salary, and house rent or sale of immovable property. |
result[data][iTR][taxCollectedAtSource] | Array | Contains information about tax collected at source (TCS). |
result[data][iTR][balanceSheet] | Object | Encompasses information related to the balance sheet, including equity and liabilities, and assets. |
result[data][iTR][profitAndLossStatement] | Object | Contains details of the profit and loss statement, including various income and expense categories. |
result[data][iTR][ratioAnalysis] | Object | Provides various financial ratios for analysis, including liquidity, asset management, leverage, coverage, profitability, and growth ratios. |

These endpoints collectively provide a streamlined process for patrons to seamlessly request and obtain ITR Analytics

Status Codes:
CODE | MESSAGE |
|---|---|
200 | Request successful |
409 | Upstream is down |
400 | Bad Request |