--- title: ITR OTP Get ITR AIS slug: api-marketplace/itr-otp-get-itr-ais createdAt: 2026-10-29T06:46:03.780Z --- ## 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 ::::Tabs :::Tab{title="Preproduction"} ```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 }' ``` ::: :::Tab{title="Production"} ```curl curl --location 'https://api.signzy.app/api/v3/itr/get-itr-ais' \ --header 'Content-Type: application/json' \ --header 'Accept: application/json' \ --header 'Authorization: 9E3qaj3jabh6MPuUuaE4Jmw5MVHbYuJm' \ --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 ```json { "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": "john.doe@example.com", "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": "john.doe@example.com", "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": "john.doe@example.com", "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 |