ITR

6 min

Introduction

This API allows patrons to request income tax returns (ITRs) for their users by providing essential details such as the URL and date of birth (DOB). The type of ITR can also be specified in the request. The API is accessible via a POST request to the Signzy API endpoint and requires authentication via an access token. The response will contain the required ITRs in the specified format.

Sample Curl

curl --request POST \
  --url 'https://preproduction.signzy.tech/api/v2/patrons/..your-patron-id../itrs' \
  --header 'Accept: */*' \
  --header 'Accept-Language: en-US,en;q=0.8' \
  --header 'Authorization: <Access-Token>' \
  --header 'content-type: application/json' \
  --data '{"type":"form26","essentials":{"url":"...url..","dob":"...dob..."}}'

Input Parameters

Parameter	Type	Description
type	string	Type of ITR form to be fetched (e.g. "form26")
essentials.url	string	URL of the ITR form
essentials.dob	string	Date of Birth of the ITR form filer in the format YYYY-MM-DD

Sample Response

    // Expected response
    {
    	"essentials": {
    		"url": "...url...",
            "dob" : "..dob.."
    	},
    	"id": "...accessToken...",
    	"patronId": "...patronId...",
    	"type": "...type...",
    	"result": {
    		"financialYear": "...financialYear...",
    		"addressofAssessee": "...addressofAssessee...",
    		"assessmentYear": "...assessmentYear...",
    		"pan": "...pan...",
    		"statusOfPan": "...statusOfPan...",
    		"nameofAssessee": "...nameofAssessee...",
    		"transactions": {
    			"a": {
    				"description": "...description...",
    				"transactions": [{
    					"srNo": "...srNo...",
    					"nameOfDeductor": "...nameOfDeductor...",
    					"tanOfDeductor": "...tanOfDeductor...",
    					"totalAmountPaidOrCreditedInInr": "...totalAmountPaidOrCreditedInInr...",
    					"totalTaxDeductedInInr": "...totalTaxDeductedInInr...",
    					"totalTDSDepositedInInr": "...totalTDSDepositedInInr..."
    				}]
    			},
    			"a1": {
    				"description": "...description...",
    				"transactions": [{
    					"srNo": "...srNo...",
    					"nameOfDeductor": "...nameOfDeductor...",
    					"tanOfDeductor": "...tanOfDeductor...",
    					"totalAmountPaidOrCreditedInInr": "...totalAmountPaidOrCreditedInInr...",
    					"totalTaxDeductedInInr": "...totalTaxDeductedInInr...",
    					"totalTDSDepositedInInr": "...totalTDSDepositedInInr..."
    				}]
    			},
    			"a2": {
    				"description": "...description...",
    				"transactions": [{
    					"srNo": "...srNo...",
    					"acknowledgementNumber": "...acknowledgementNumber...",
    					"nameOfDeductor": "...nameOfDeductor...",
    					"panOfDeductor": "...panOfDeductor...",
    					"transactionDate": "...transactionDate...",
    					"totalTransactionAmountInInr": "...totalTransactionAmountInInr...",
    					"totalTDSDepositedInInr": "...totalTDSDepositedInInr..."
    				}]
    			},
    			"b": {
    				"description": "...description...",
    				"transactions": [{
    					"srNo": "...srNo...",
    					"nameOfCollector": "...nameOfCollector...",
    					"tanOfCollector": "...tanOfCollector...",
    					"totalAmountPaidOrDebitedInInr": "...totalAmountPaidOrDebitedInInr...",
    					"totalTaxCollectedInInr": "...totalTaxCollectedInInr...",
    					"totalTCSDepositedInInr": "...totalTCSDepositedInInr..."
    				}]
    			},
    			"c": {
    				"description": "...description...",
    				"transactions": [{
    					"srNo": "...srNo...",
    					"majorHead": "...majorHead...",
    					"minorHead": "...minorHead...",
    					"taxInInr": "...taxInInr...",
    					"surchargeInInr": "...surchargeInInr...",
    					"educationCessInInr": "...educationCessInInr...",
    					"others": "...others...",
    					"totalTaxInInr": "...totalTaxInInr...",
    					"bsrCode": "...bsrCode...",
    					"dateOfDeposit": "...dateOfDeposit...",
    					"challanSerialNumber": "...challanSerialNumber...",
    					"remarks": "...remarks..."
    				}]
    			},
    			"d": {
    				"description": "...description...",
    				"transactions": [{
    					"srNo": "...srNo...",
    					"assessmentYear": "...assessmentYear...",
    					"mode": "...mode...",
    					"refundIssued": "...refundIssued...",
    					"natureOfRefund": "...natureOfRefund...",
    					"amountOfRefundInInr": "...amountOfRefundInInr...",
    					"interestInInr": "...interestInInr...",
    					"dateOfPayment": "...dateOfPayment...",
    					"remarks": "...remarks..."

    				}]
    			},
    			"e": {
    				"description": "...description...",
    				"transactions": [{
    					"srNo": "...srNo...",
    					"typeOfTransaction": "...typeOfTransaction...",
    					"nameOfAIRFiler": "...nameOfAIRFiler...",
    					"transactionDate": "...transactionDate...",
    					"singleOrJointPartyTransaction": "...singleOrJointPartyTransaction...",
    					"numberOfParties": "...numberOfParties...",
    					"amountInInr": "...amountInInr...",
    					"mode": "...mode...",
    					"remarks": "...remarks..."
    				}]
    			},
    			"f": {
    				"description": "...description...",
    				"transactions": [{
    					"srNo": "...srNo...",
    					"acknowledgementNumber": "...acknowledgementNumber...",
    					"nameOfDeductee": "...nameOfDeductee...",
    					"panOfDeductee": "...panOfDeductee...",
    					"transactionDate": "...transactionDate...",
    					"totalTransactionAmountInInr": "...totalTransactionAmountInInr...",
    					"totalTDSDepositedInInr": "...totalTDSDepositedInInr...",
    					"totalAmountDepositedOtherThanTDSInInr": "...totalAmountDepositedOtherThanTDSInInr..."
    				}]
    			},
    			"g": {
    				"description": "...description...",
    				"transactions": [{
    					"srNo": "...srNo...",
    					"financialYear": "...financialYear...",
    					"shortPayment": "...shortPayment...",
    					"shortDeduction": "...shortDeduction...",
    					"interestOnTDSPaymentsDefaultInInr": "...interestOnTDSPaymentsDefaultInInr...",
    					"InterestOnTDSDeductionDefaultInInr": "...InterestOnTDSDeductionDefaultInInr...",
    					"lateFillingFeeUS234EInInr": "...lateFillingFeeUS234EInInr...",
    					"interestUS220(2InInr)": "...)...",
    					"totalDefaultInInr": "...totalDefaultInInr..."
    				}]
    			}
    		}
    	}

    }

Output Parameters

Parameter	Type	Description
essentials.url	string	URL submitted in the request
essentials.dob	string	Date of Birth of the user
id	string	Access token
patronId	string	Patron ID
type	string	Type of request
result.financialYear	string	Financial year of the assessment
result.addressofAssessee	string	Address of the assessee
result.assessmentYear	string	Assessment year
result.pan	string	PAN number of the assessee
result.statusOfPan	string	Status of the PAN
result.nameofAssessee	string	Name of the assessee
result.transactions.a	object	Object containing the details of TDS on Salaries and Fees (other than interest)
result.transactions.a.description	string	Description of TDS on Salaries and Fees (other than interest)
result.transactions.a.transactions	array	Array of objects containing the details of TDS on Salaries and Fees (other than interest)
result.transactions.a.transactions.srNo	string	Serial number of the transaction
result.transactions.a.transactions.nameOfDeductor	string	Name of the deductor
result.transactions.a.transactions.tanOfDeductor	string	TAN of the deductor
result.transactions.a.transactions.totalAmountPaidOrCreditedInInr	string	Total amount paid or credited in INR
result.transactions.a.transactions.totalTaxDeductedInInr	string	Total tax deducted in INR
result.transactions.a.transactions.totalTDSDepositedInInr	string	Total TDS deposited in INR
result.transactions.a1	object	Object containing the details of TDS on Interest other than interest on securities
result.transactions.a1.description	string	Description of TDS on Interest other than interest on securities
result.transactions.a1.transactions	array	Array of objects containing the details of TDS on Interest other than interest on securities
result.transactions.a1.transactions.srNo	string	Serial number of the transaction
result.transactions.a1.transactions.nameOfDeductor	string	Name of the deductor
result.transactions.a1.transactions.tanOfDeductor	string	TAN of the deductor
result.transactions.a1.transactions.totalAmountPaidOrCreditedInInr	string	Total amount paid or credited in INR
result.transactions.a1.transactions.totalTaxDeductedInInr	string	Total tax deducted in INR
result.transactions.a1.transactions.totalTDSDepositedInInr	string	Total TDS deposited in INR
result.transactions.a2	object	Object containing the details of TDS on Interest on securities
result.transactions.a2.description	string	Description of TDS on Interest on securities
result.transactions.a2.transactions	array	Array of objects containing the details of TDS on Interest on securities
result.transactions.a2.transactions.srNo	string	Serial number of the transaction
result.transactions.a2.transactions.acknowledgementNumber	string	Acknowledgement number of the transaction
result.transactions.a2.transactions.nameOfDeductor	string	Name of the deductor
result.transactions.a2.transactions.panOfDeductor	string	PAN of the deductor
result.transactions.a2.transactions.transactionDate	string	Date of the transaction
result.transactions.a2.transactions.totalTransactionAmountInInr	string	Total transaction amount in INR
result.transactions.a2.transactions.totalTDSDepositedInInr	string	Total TDS deposited in INR
result.transactions.b	object	Object containing the details of TCS
result.transactions.b.description	string	Description of TCS
result.transactions.b.transactions	array	Array of objects containing the details

Status Codes

CODE	MESSAGE
200	OK
404	Not found
400	Invalid Data