ITR Verification

Introduction:

ITR-V or ITR verification is an acknowledgement/receipt of the income tax return filed by the taxpayer. It is typically signed and submitted to the Income Tax Office by the taxpayer. It is a confirmation from the taxpayer that with the Income Tax Office of the Income Tax Filed by the customer. It is the simplicity of the information provided that makes this report useful. It has aggregate information at a yearly level of personal details, income, debts, tax liability, and taxes paid. It is an essential source to understand the earning status of the customer.

This API allows patrons to fetch the ITR V details by providing a username and password.

Sample Curl:

curl --location 'https://api-preproduction.signzy.app/api/v3/itr/itr-verification' \
--header 'Authorization: <Auth-Token>' \
--header 'Content-Type: application/json' \
--data '{
    "userName" : "ABCDE1234F",
    "password" : "Test@123",
    "range": 3,
    "pdfBase64": false
}'

Input Parameters:

Parameter	Type	Description	Mandatory/Optional
userName	String	Username of the itr portal. Typically it the pan of the user	Mandatory
password	String	password of the itr portal	Conditional Mandatory
sessionId	String	This is the same id provided in the response of other ITR APIs and allows to fetch data without the need to explicitly login. Either password or sessionId can be passed.	Conditional Mandatory
range	Number	The number of years for which data is being requested	Optional
pdfBase64	Boolean	Flag to get base64 version of itr pdf	Optional

Sample Response:

{
    "userName": "ABCDE1234F",
    "password" : "Test@123",
    "sessionId": "itr_AmsPPsLuWpGbyOYxAqpX",
    "range": 3,
    "panNumber": "ABCDE1234F",
    "result": [
        {
            "assessmentYear": "https://aadhaar-kyc-docs.s3.amazonaws.com/itr/itr_erwHufsYithiwyXbzdNk/AAWCS3552Q/462158851290023_itrv-2024-01-23-141947950483.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAY5K3QRM5FYWPQJEB%2F20240123%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20240123T141948Z&X-Amz-Expires=600&X-Amz-SignedHeaders=host&X-Amz-Signature=c7680001d761a687dbed5d340e0993bf55253c179483510b530059f09a566264",
            "panNumber": "ABCDE1234F",
            "filingYear": "2022-2023",
            "itrVbase64": "rO0ABXVyABNbTGphdmEubGFuZy5PYmplY3Q7kM5YnxBzKWwCAAB4cAAAAAJzcgARamF2YS51dGlsLkhhc2hNYXAFB9rBwxZg0QMAAkYACmxvYWRGYWN0b3JJAAl0aHJlc2hvbGR4cD9AAAAAAAAMdwgAAAAQAAAAA3QAEVRyYW5zZmVyLUVuY29kaW5ndAAHY2h1"
            "acknowledgementNumber": "462158851291013",
            "filingType": "Original"
        },
        {
            "assessmentYear": "https://aadhaar-kyc-docs.s3.amazonaws.com/itr/itr_erwHufsYithiwyXbzdNk/AAWCS3552Q/773385701020122_itrv-2024-01-23-141948243298.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAY5K3QRM5FYWPQJEB%2F20240123%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20240123T141948Z&X-Amz-Expires=600&X-Amz-SignedHeaders=host&X-Amz-Signature=59a8e079020a4a639deb08feae55138df13be54c1d7b7d49fda34e582782c8f2",
            "panNumber": "ABCDE1234F",
            "filingYear": "2021-2022",
            "itrVbase64": "rO0ABXVyABNbTGphdmEubGFuZy5PYmplY3Q7kM5YnxBzKWwCAAB4cAAAAAJzcgARamF2YS51dGlsLkhhc2hNYXAFB9rBwxZg0QMAAkYACmxvYWRGYWN0b3JJAAl0aHJlc2hvbGR4cD9AAAAAAAAMdwgAAAAQAAAAA3QAEVRyYW5zZmVyLUVuY29kaW5ndAAHY2h2"
            "acknowledgementNumber": "773385701021112",
            "filingType": "Original"
        },
        {
            "assessmentYear": "https://aadhaar-kyc-docs.s3.amazonaws.com/itr/itr_erwHufsYithiwyXbzdNk/AAWCS3552Q/336646720102322_itrv-2024-01-23-141948553353.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAY5K3QRM5FYWPQJEB%2F20240123%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20240123T141948Z&X-Amz-Expires=600&X-Amz-SignedHeaders=host&X-Amz-Signature=6486b15aa3e33b0b7a89b3d97c9ab04a899011cec588397cc4bab4e54b71968d",
            "panNumber": "ABCDE1234F",
            "filingYear": "2020-2021",
            "itrVbase64": "rO0ABXVyABNbTGphdmEubGFuZy5PYmxplY3Q7kM5YnxBzKWwCAAB4cAAAAAJzcgARamF2YS51dGlsLkhhc2hNYXAFB9rBwxZg0QMAAkYACmxvYWRGYWN0b3JJAAl0aHJlc2hvbGR4cD9AAAAAAAAMdwgAAAAQAAAAA3QAEVRyYW5zZmVyLUVuY29kaW5ndAAHY2h3"
            "acknowledgementNumber": "336646720120312",
            "filingType": "Original"
        }
    ],
    "message": "3 years ITR V available in the last 3 years",
    "statusCode": 200
}

Output Parameters

Parameter	Type	Description
clientId	String	Client id generated for the user’s session
panNumber	String
result	list	Object that contains the last 3 years itr v data
result[].assessmentYear	link	The assessment year for the Income Tax Return (ITR). It provides a link to the PDF document of the ITR.
result[].panNumber	String	The PAN associated with the specific ITR
result[].filingYear	String	The financial year during which the income was earned, and the return was filed. Example: "2022-2023". Example: "462158851291013"
result[].acknowledgementNumber	String	A unique number assigned to each filed Income Tax Return (ITR)
result[].filingType	String	The type of filing, such as "Original" indicating an original filing. Example: "Original".
result[].itrVbase64	String	base64 string of link to the PDF document of the ITR.
message	String	A descriptive message providing information about the ITRs. Example: "3 years ITR V available in the last 3 years".
statusCode	integer	The HTTP status code indicating the success or failure of the request. Example: 200 for a successful response.

Status Codes:

Code	Reason
400	Bad request
422	Unauthorized - Wrong user ID or password, cannot login
409	Upstream error
500	Internal Server Error