ITR OTP Get ITR AIS
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.
Sample Curl
curl --location 'https://api-preproduction.signzy.app/api/v3/itr/get-itr-ais' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: IjZ7NidM7IlpLY4gPfzb0vUHriA7r67P' \
--data '{
"requestId": output of the requestId
}'
Request Headers
PARAMETER NAME | Value | DESCRIPTION |
|---|---|---|
Content-Type | application/json | Content Type |
Authorization | shared by Signzy | Authorization token for the api |
Input Parameters

PARAMETER NAME | REQUIRED | Type | DESCRIPTION |
|---|---|---|---|
requestId | YES | string (UUID) | RequestId generated by the ITR OTP Get Request ID |
range | No | Number | The number of years for which the data must be given for. Default: 3 |
Sample Response
{
"requestId": "00000000-0000-4000-8000-000000000000",
"panNumber": "ABCDE1234F",
"result": {
"filledItrs": [
{
"2024-2025": [
{
"panNumber": "ABCDE1234F",
"filingYear": "2024-2025",
"ais": {
"pan": "ABCDE1234F",
"document_name": "Annual Information Statement (AIS)",
"financial_year": "2024-25",
"general_information": [
{
"permanent_account_number_pan": "ABCDE1234F",
"aadhaar_number": "XXXX XXXX 1234",
"name_of_assessee": "JOHN SAMPLE DOE",
"date_of_birth": "01/01/1990",
"mobile_number": "9999999999",
"e_mail_address": "[email protected]",
"address": "SAMPLE RESIDENTIAL SOCIETY, SAMPLE ROAD, SAMPLE AREA, SAMPLE CITY, SAMPLE CITY, 400001, MAHARASHTRA"
}
],
"sections": [
{
"key": "tdsTcs",
"title": "Part B1-Information relating to tax deducted or collected at source",
"heading": "TDS/TCS Information",
"sub_section": [],
"elements": [
{
"title": "Interest from deposit",
"summary": [
{
"information_code": "TDS-194A",
"information_description": "Interest other than \"Interest on Securities\" received (Section 194A)",
"information_source": "SAMPLE BANK LIMITED (SMPL00000E)",
"count": "1",
"amount": "10,909"
}
],
"details": [
{
"quarter": "Q4(Jan-Mar)",
"date_of_payment_credit": "31/03/2025",
"amount_paid_credited": "10,909",
"tds_deducted": "1,632",
"tds_deposited": "1,632",
"status": "Active"
},
{
"quarter": "Q4(Jan-Mar)",
"date_of_payment_credit": "31/03/2025",
"amount_paid_credited": "10,909",
"tds_deducted": "1,632",
"tds_deposited": "1,632",
"status": "Inactive"
}
]
}
]
},
{
"key": "sft",
"title": "Part B2-Information relating to specified financial transaction (SFT)",
"heading": "SFT Information",
"sub_section": [],
"elements": [
{
"title": "Dividend",
"summary": [
{
"information_code": "SFT-015",
"information_description": "Dividend income (SFT-015)",
"information_source": "SAMPLE POWER CO LTD (SMPLT0000A.AZ000)",
"count": "1",
"amount": "376"
}
],
"details": [
{
"reported_on": "08/05/2025",
"dividend_amount": "376",
"status": "Active"
}
]
},
{
"title": "Interest from savings bank",
"summary": [
{
"information_code": "SFT-016(SB)",
"information_description": "Interest income (SFT-016) - Savings ",
"information_source": "SAMPLE BANK LIMITED (SMPLH0000H.AB000)",
"count": "2",
"amount": "1,070"
}
],
"details": [
{
"reported_on": "06/05/2025",
"account_number": "XXXXXXXXXX0001",
"account_type": "Saving",
"interest_amount": "61",
"status": "Active"
},
{
"reported_on": "06/05/2025",
"account_number": "XXXXXXXXXX0002",
"account_type": "Saving",
"interest_amount": "1,009",
"status": "Active"
}
]
},
{
"title": "Interest from deposit",
"summary": [
{
"information_code": "SFT-016(TD)",
"information_description": "Interest income (SFT-016) - Term Deposit",
"information_source": "SAMPLE BANK LIMITED (SMPLH0000H.AB000)",
"count": "2",
"amount": "4,126"
}
],
"details": [
{
"reported_on": "06/05/2025",
"account_number": "XXXXXXXXXX0003",
"account_type": "Time Deposit",
"interest_amount": "827",
"status": "Active"
},
{
"reported_on": "06/05/2025",
"account_number": "XXXXXXXXXX0004",
"account_type": "Time Deposit",
"interest_amount": "3,299",
"status": "Active"
}
]
},
{
"title": "Sale of securities and units of mutual fund",
"summary": [
{
"information_code": "SFT-17-LES(M)",
"information_description": "Sale of listed equity share (Depository)",
"information_source": "SAMPLE DEPOSITORY SERVICES LIMITED (SMPLC0000AMUMC00000A)",
"count": "2",
"amount": "86,999.00"
}
],
"details": [
{
"date_of_sale_transfer": "25/09/2024",
"security_name_security_code": "SAMPLE COMPANY LIMITED-EQUITY SHARES OF RE.1/-(INE000A00000)",
"security_class": "Listed Equity Share",
"debit_type": "Market",
"credit_type": "Market",
"asset_type": "Short term",
"quantity": "100.00",
"sale_price_per_unit": "471.60",
"sales_consideration": "47,160",
"cost_of_acquisition": "44,210.00",
"unit_fmv": "89.10",
"fair_market_value": "8,910.00",
"indexed_cost_of_acquisition": "0",
"status": "Active"
},
{
"date_of_sale_transfer": "23/09/2024",
"security_name_security_code": "SAMPLE FINANCIAL SERVICES LIMITED-EQUITY SHARES(INE000A00001)",
"security_class": "Listed Equity Share",
"debit_type": "Market",
"credit_type": "Market",
"asset_type": "Short term",
"quantity": "65.00",
"sale_price_per_unit": "350.00",
"sales_consideration": "22,750",
"cost_of_acquisition": "22,002.50",
"unit_fmv": "0",
"fair_market_value": "0",
"indexed_cost_of_acquisition": "0",
"status": "Active"
}
]
},
{
"title": "Purchase of securities and units of mutual funds",
"summary": [
{
"information_code": "SFT-17(Pur)",
"information_description": "Purchase of securities (SFT - 017)",
"information_source": "SAMPLE DEPOSITORY SERVICES LIMITED (SMPLC0000AMUMC00000A)",
"count": "1",
"amount": "11,86,026"
}
],
"details": [
{
"quarter": "Q2(Jul-Sep)",
"client_id": "SAMPLE00001",
"holder_flag": "First",
"market_purchase": "11,86,026",
"market_sales": "11,11,013",
"status": "Active"
}
]
},
{
"title": "Purchase of securities and units of mutual funds",
"summary": [
{
"information_code": "SFT-18(Pur)",
"information_description": "Purchase of mutual funds (SFT - 018)",
"information_source": "SAMPLE RTA SERVICES LIMITED - SAMPLE ASSET MANAGEMENT LIMITED(IF) (SMPLC0000G.AZ000)",
"count": "1",
"amount": "24,999"
}
],
"details": [
{
"quarter": "Q4(Jan-Mar)",
"client_id": "SAMPLE00002",
"amc_name_code": "SAMPLE ASSET MANAGEMENT LIMITED(IF)",
"holder_flag": "First",
"total_purchase_amount": "24,999",
"total_sales_value": "0",
"status": "Active"
}
]
}
]
},
{
"key": "other-info",
"title": "Part B7-Any other information in relation to sub-rule (2) of rule 114-I",
"heading": "Other Information",
"sub_section": [],
"elements": [{ "title": "", "summary": [], "details": [] }]
},
{
"key": "paymentOfTaxes",
"title": "Part B3-Information relating to payment of taxes",
"heading": "Payment of Taxes",
"sub_section": [],
"elements": [{ "title": "", "summary": [], "details": [] }]
},
{
"key": "demandAndRefund",
"title": "Part B4-Information relating to demand and refund",
"heading": "Demand and Refund",
"sub_section": [
{
"key": "refund",
"title": "Refund",
"heading": "",
"elements": []
}
],
"elements": []
}
]
}
}
],
"2025-2026": [
{
"panNumber": "ABCDE1234F",
"filingYear": "2025-2026",
"ais": {
"pan": "ABCDE1234F",
"document_name": "Annual Information Statement (AIS)",
"financial_year": "2025-26",
"general_information": [
{
"permanent_account_number_pan": "ABCDE1234F",
"aadhaar_number": "XXXX XXXX 1234",
"name_of_assessee": "JOHN SAMPLE DOE",
"date_of_birth": "01/01/1990",
"mobile_number": "9999999999",
"e_mail_address": "[email protected]",
"address": "SAMPLE RESIDENTIAL SOCIETY, SAMPLE ROAD, SAMPLE AREA, SAMPLE CITY, SAMPLE CITY, 400001, MAHARASHTRA"
}
],
"sections": [
{
"key": "tdsTcs",
"title": "Part B1-Information relating to tax deducted or collected at source",
"heading": "TDS/TCS Information",
"sub_section": [],
"elements": [
{
"title": "Salary",
"summary": [
{
"information_code": "TDS-192",
"information_description": "Salary received (Section 192)",
"information_source": "SAMPLE EMPLOYER ORGANIZATION (SMPLS00000C)",
"count": "1",
"amount": "77,739"
}
],
"details": [
{
"quarter": "Q4(Jan-Mar)",
"date_of_payment_credit": "01/03/2026",
"amount_paid_credited": "77,739",
"tds_deducted": "0",
"tds_deposited": "0",
"status": "Active"
}
]
},
{
"title": "Dividend",
"summary": [
{
"information_code": "TDS-194",
"information_description": "Dividend received (Section 194)",
"information_source": "SAMPLE COMPANY LIMITED (SMPLI00000C)",
"count": "2",
"amount": "220"
}
],
"details": [
{
"quarter": "Q4(Jan-Mar)",
"date_of_payment_credit": "25/02/2026",
"amount_paid_credited": "120",
"tds_deducted": "0",
"tds_deposited": "0",
"status": "Active"
},
{
"quarter": "Q3(Oct-Dec)",
"date_of_payment_credit": "01/10/2025",
"amount_paid_credited": "100",
"tds_deducted": "0",
"tds_deposited": "0",
"status": "Active"
}
]
}
]
},
{
"key": "sft",
"title": "Part B2-Information relating to specified financial transaction (SFT)",
"heading": "SFT Information",
"sub_section": [],
"elements": [
{
"title": "Dividend",
"summary": [
{
"information_code": "SFT-015",
"information_description": "Dividend income (SFT-015)",
"information_source": "SAMPLE COMPANY LIMITED (SMPLI0000H.AZ000)",
"count": "2",
"amount": "220"
}
],
"details": [
{
"reported_on": "25/05/2026",
"dividend_amount": "100",
"status": "Active"
},
{
"reported_on": "22/05/2026",
"dividend_amount": "120",
"status": "Active"
}
]
},
{
"title": "Interest from savings bank",
"summary": [
{
"information_code": "SFT-016(SB)",
"information_description": "Interest income (SFT-016) - Savings ",
"information_source": "SAMPLE BANK LIMITED (SMPLH0000H.AB000)",
"count": "2",
"amount": "1,273"
}
],
"details": [
{
"reported_on": "07/05/2026",
"account_number": "XXXXXXXXXX0002",
"account_type": "Saving",
"interest_amount": "1,192",
"status": "Active"
},
{
"reported_on": "07/05/2026",
"account_number": "XXXXXXXXXX0001",
"account_type": "Saving",
"interest_amount": "81",
"status": "Active"
}
]
},
{
"title": "Interest from deposit",
"summary": [
{
"information_code": "SFT-016(TD)",
"information_description": "Interest income (SFT-016) - Term Deposit",
"information_source": "SAMPLE BANK LIMITED (SMPLH0000H.AB000)",
"count": "2",
"amount": "1,499"
}
],
"details": [
{
"reported_on": "07/05/2026",
"account_number": "XXXXXXXXXX0003",
"account_type": "Time Deposit",
"interest_amount": "781",
"status": "Active"
},
{
"reported_on": "07/05/2026",
"account_number": "XXXXXXXXXX0004",
"account_type": "Time Deposit",
"interest_amount": "718",
"status": "Active"
}
]
},
{
"title": "Sale of securities and units of mutual fund",
"summary": [
{
"information_code": "SFT-17-LES(M)",
"information_description": "Sale of listed equity share (Depository)",
"information_source": "SAMPLE DEPOSITORY SERVICES LIMITED (SMPLC0000AMUMC00000A)",
"count": "2",
"amount": "17,415.00"
}
],
"details": [
{
"date_of_sale_transfer": "17/11/2025",
"security_name_security_code": "SAMPLE MOTORS LIMITED-EQUITY SHARES(INE000A00002)",
"security_class": "Listed Equity Share",
"debit_type": "Market",
"credit_type": "Off market",
"asset_type": "Short term",
"quantity": "30.00",
"sale_price_per_unit": "312.23",
"sales_consideration": "9,367",
"cost_of_acquisition": "0",
"unit_fmv": "0",
"fair_market_value": "0",
"indexed_cost_of_acquisition": "0",
"status": "Active"
},
{
"date_of_sale_transfer": "18/06/2025",
"security_name_security_code": "SAMPLE BANK LIMITED-EQUITY SHARES(INE000A00003)",
"security_class": "Listed Equity Share",
"debit_type": "Market",
"credit_type": "Market",
"asset_type": "Long term",
"quantity": "75.00",
"sale_price_per_unit": "107.31",
"sales_consideration": "8,048",
"cost_of_acquisition": "9,557.25",
"unit_fmv": "171.25",
"fair_market_value": "12,843.75",
"indexed_cost_of_acquisition": "0",
"status": "Active"
}
]
},
{
"title": "Purchase of time deposits",
"summary": [
{
"information_code": "SFT-005",
"information_description": "Purchase of time deposits (SFT-005)",
"information_source": "SAMPLE BANK LIMITED (SMPLH0000H.AB000)",
"count": "1",
"amount": "14,49,800"
}
],
"details": [
{
"reported_on": "27/05/2026",
"gross_amount_received_from_the_person": "14,49,800",
"gross_amount_paid_to_the_person": "14,57,800",
"status": "Active"
}
]
},
{
"title": "Purchase of securities and units of mutual funds",
"summary": [
{
"information_code": "SFT-18(Pur)",
"information_description": "Purchase of mutual funds (SFT - 018)",
"information_source": "SAMPLE RTA SERVICES LIMITED - SAMPLE ASSET MANAGEMENT LIMITED(IF) (SMPLC0000G.AZ000)",
"count": "2",
"amount": "54,997"
}
],
"details": [
{
"quarter": "Q4(Jan-Mar)",
"client_id": "SAMPLE00001",
"amc_name_code": "SAMPLE ASSET MANAGEMENT LIMITED(IF)",
"holder_flag": "First",
"total_purchase_amount": "24,999",
"total_sales_value": "80,568",
"status": "Active"
},
{
"quarter": "Q2(Jul-Sep)",
"client_id": "SAMPLE00001",
"amc_name_code": "SAMPLE ASSET MANAGEMENT LIMITED(IF)",
"holder_flag": "First",
"total_purchase_amount": "29,998",
"total_sales_value": "0",
"status": "Active"
}
]
}
]
},
{
"key": "other-info",
"title": "Part B7-Any other information in relation to sub-rule (2) of rule 114-I",
"heading": "Other Information",
"sub_section": [],
"elements": [
{
"title": "Salary",
"summary": [
{
"information_code": "TDS-Ann.II-SAL",
"information_description": "Salary (TDS Annexure II)",
"information_source": "SAMPLE EMPLOYER ORGANIZATION (SMPLS00000C)",
"count": "1",
"amount": "9,01,764"
}
],
"details": [
{
"employment_start_date": "01/04/2025",
"employment_end_date": "31/03/2026",
"gross_salary_u_s_17_1": "9,01,764",
"value_of_perquisites_u_s_17_2": "0",
"profits_in_lieu_of_salary_u_s_17_3": "0",
"gross_salary": "9,01,764",
"status": "Active"
}
]
}
]
},
{
"key": "paymentOfTaxes",
"title": "Part B3-Information relating to payment of taxes",
"heading": "Payment of Taxes",
"sub_section": [],
"elements": [{ "title": "", "summary": [], "details": [] }]
},
{
"key": "demandAndRefund",
"title": "Part B4-Information relating to demand and refund",
"heading": "Demand and Refund",
"sub_section": [
{
"key": "refund",
"title": "Refund",
"heading": "",
"elements": []
}
],
"elements": []
}
]
}
}
],
"message": "2 year AIS data available in the last 3 year(s)"
}
],
"notFilledItrs": [
{
"2023-2024": [
{
"panNumber": "ABCDE1234F",
"filingYear": "2023-2024",
"ais": {
"pan": "ABCDE1234F",
"document_name": "Annual Information Statement (AIS)",
"financial_year": "2023-24",
"general_information": [
{
"permanent_account_number_pan": "ABCDE1234F",
"aadhaar_number": "XXXX XXXX 1234",
"name_of_assessee": "JOHN SAMPLE DOE",
"date_of_birth": "01/01/1990",
"mobile_number": "9999999999",
"e_mail_address": "[email protected]",
"address": "SAMPLE RESIDENTIAL SOCIETY, SAMPLE ROAD, SAMPLE AREA, SAMPLE CITY, SAMPLE CITY, 400001, MAHARASHTRA"
}
],
"sections": [
{
"key": "tdsTcs",
"title": "Part B1-Information relating to tax deducted or collected at source",
"heading": "TDS/TCS Information",
"sub_section": [],
"elements": [{ "title": "", "summary": [], "details": [] }]
},
{
"key": "sft",
"title": "Part B2-Information relating to specified financial transaction (SFT)",
"heading": "SFT Information",
"sub_section": [],
"elements": [
{
"title": "Interest from savings bank",
"summary": [
{
"information_code": "SFT-016(SB)",
"information_description": "Interest income (SFT-016) - Savings ",
"information_source": "SAMPLE BANK LIMITED (SMPLH0000H.AB000)",
"count": "2",
"amount": "1,039"
}
],
"details": [
{
"reported_on": "13/05/2024",
"account_number": "XXXXXXXXXX0002",
"account_type": "Saving",
"interest_amount": "1,012",
"status": "Active"
},
{
"reported_on": "13/05/2024",
"account_number": "XXXXXXXXXX0001",
"account_type": "Saving",
"interest_amount": "27",
"status": "Active"
}
]
},
{
"title": "Interest from deposit",
"summary": [
{
"information_code": "SFT-016(TD)",
"information_description": "Interest income (SFT-016) - Term Deposit",
"information_source": "SAMPLE BANK LIMITED (SMPLH0000H.AB000)",
"count": "2",
"amount": "3,966"
}
],
"details": [
{
"reported_on": "13/05/2024",
"account_number": "XXXXXXXXXX0005",
"account_type": "Time Deposit",
"interest_amount": "341",
"status": "Active"
},
{
"reported_on": "13/05/2024",
"account_number": "XXXXXXXXXX0006",
"account_type": "Time Deposit",
"interest_amount": "3,625",
"status": "Active"
}
]
}
]
},
{
"key": "other-info",
"title": "Part B7-Any other information in relation to sub-rule (2) of rule 114-I",
"heading": "Other Information",
"sub_section": [],
"elements": [{ "title": "", "summary": [], "details": [] }]
},
{
"key": "paymentOfTaxes",
"title": "Part B3-Information relating to payment of taxes",
"heading": "Payment of Taxes",
"sub_section": [],
"elements": [{ "title": "", "summary": [], "details": [] }]
},
{
"key": "demandAndRefund",
"title": "Part B4-Information relating to demand and refund",
"heading": "Demand and Refund",
"sub_section": [
{
"key": "refund",
"title": "Refund",
"heading": "",
"elements": []
}
],
"elements": []
}
]
}
}
],
"message": "1 year AIS data available in unfilled years 2023-2024"
}
]
},
"statusCode": 200
}
Response Parameter

Parameter | Type | Description |
|---|---|---|
requestId | String | Unique ID to identify the request. |
panNumber | String | PAN Number of the individual or entity. |
statusCode | Number | Represents the HTTP status code of the response. |
result | Object | Contains the AIS data grouped by filing status (filed / not filed). |
result.filledItrs | Array | List of financial years for which an ITR was filed, each with its AIS data. |
result.filledItrs[].[financial-year] | Array | AIS record(s) for a given financial year, e.g. filledItrs[0]["2024-2025"]. |
result.filledItrs[].[financial-year].panNumber | String | PAN Number for this financial year record. |
result.filledItrs[].[financial-year].filingYear | String | Financial year in YYYY-YYYY format. |
result.filledItrs[].[financial-year].ais | Object | The full AIS document for this financial year. |
result.filledItrs[].[financial-year].ais.pan | String | PAN this AIS is issued for. |
result.filledItrs[].[financial-year].ais.document_name | String | Always "Annual Information Statement (AIS)". |
result.filledItrs[].[financial-year].ais.financial_year | String | Financial year in Y-YY format, e.g. "2024-25". |
result.filledItrs[].[financial-year].ais.general_information.permanent_account_number_pan | String | PAN of the assessee. |
result.filledItrs[].[financial-year].ais.general_information.aadhaar_number | String | Masked Aadhaar number. |
result.filledItrs[].[financial-year].ais.general_information.name_of_assessee | String | Full name on record. |
result.filledItrs[].[financial-year].ais.general_information.date_of_birth | String | Date of birth, DD/MM/YYYY. |
result.filledItrs[].[financial-year].ais.general_information.mobile_number | String | Registered mobile number. |
result.filledItrs[].[financial-year].ais.general_information.e_mail_address | String | Registered email address. |
result.filledItrs[].[financial-year].ais.general_information.address | String | Full registered address. |
result.filledItrs[].[financial-year].ais.sections | Array | List of AIS parts (TDS/TCS, SFT, taxes paid, demand & refund, etc.), each with key, title, heading, sub_section, and elements[] (line items). |
result.filledItrs[].message | String | Summary message, e.g. "2 year AIS data available in the last 3 year(s)". |
result.notFilledItrs | Array | Same shape as filledItrs, for financial years where no ITR was filed. |
result.notFilledItrs[].message | String | Summary message, e.g. "1 year AIS data available in unfilled years 2023-2024". |
Status Codes

CODE | MESSAGE |
|---|---|
200 | Request successful |
409 | Upstream is down |
400 | Bad Request - Mandatory parameters missing or incorrent request ID |