ITR AIS Download

Introduction:

The ITR Annual Information Statement API (ITR AIS API) serves as a consolidated tax statement that provides a detailed view of a taxpayer’s financial transactions for a particular year. It provides clients with accurate and comprehensive view of financial transactions from various sources.

Key Features

Comprehensive Data Aggregation : ITR AIS compiles data from various sources, offering a holistic view of financial transactions.
User-Friendly Interface : Simplifies the process of reviewing and understanding complex financial data.

Benefits

Enhanced Transparency : Helps clients understand their users financial footprint and tax obligations better.
Error Reduction : Minimizes discrepancies by getting pre-filled tax return forms based on the data in AIS.
Comprehensive : It is an indespensible tool for underwriting business loans of small to medium clients

Conclusion

The ITR AIS is an indispensable tool for clients, streamlining the process of assessing users financial footprint.

Sample Curls:

curl --location 'https://api-preproduction.signzy.app/api/v3/itr/ais' \
--header 'Authorization: <auth-token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userName" : "ABCDE1234F",
    "password" : "Test@123",
    "sessionId": "itr_FptfueMThWKjRIwmqCdf",
    "range": 3
}'

Input Parameters:

Parameter	Type	Description	Mandatory/Optional
userName	String	Username of the ITR portal. Typically it is the PAN of the user	Mandatory
password	String	Password of the ITR portal	Conditional Mandatory
sessionId	String	Unique identifier for the session.	Conditional Mandatory
range	Number	The number of years for which data is being requested	Optional (Default value will be 3 years)

Conditional Mandatory: Either sessionId or password are required

Sample Response:

{
    "sessionId": "itr_FptfueMThWKjRIwmqCdf",
    "result": {
        "2023-24": {
            "panNumber": "ABCDE1234F",
            "financialYear": "2023-24",
            "fileType": "json",
            "aisData": "https://dummy-url.com/itr/dummySessionId12345/ABCDE1234F/dummy-file-2023-24.json"
        },
        "2022-23": {
            "panNumber": "ABCDE1234F",
            "financialYear": "2022-23",
            "fileType": "json",
            "aisData": "https://dummy-url.com/itr/dummySessionId12345/ABCDE1234F/dummy-file-2022-23.json"
        },
        "2021-22": {
            "panNumber": "ABCDE1234F",
            "financialYear": "2021-22",
            "fileType": "json",
            "aisData": "https://dummy-url.com/itr/dummySessionId12345/ABCDE1234F/dummy-file-2021-22.json"
        }
    },
    "status": "success",
    "statusCode": 200
}

Output Parameters:

Parameter	Type	Description
sessionId	String	Unique ID to identify the request.
result	Object	Contains the list of AIS data for each financial year specified in the range
result[financial-year]	Object	Contains the AIS data of financial-yer
result[financial-year].panNumber	String	PAN Number of the Individual
result[financial-year].financialYear	String	Financial Year value in Y-YY format
result[financial-year].fileType	String	Represents the file type. Eg: json
result[financial-year].aisData	String	Link to download AIS Data in JSON format.
status	String	Represents the status of the request
statusCode	String	Represents the HTTP status code of the response

Status Codes:

CODE	MESSAGE
200	Request successful
409	Upstream is down
422	Unauthorized - Wrong user ID or password, cannot log in
400	Bad Request - Mandatory parameters missing
404	No data available with ITD