Form 26AS Pull

Introduction

This API allows patrons to request Form 26AS TDS data of their users for upto the last 7 years by providing essential details such as the PAN, password or sessionId of their ITR portal. The response will contain the required data in the specified format.

Sample curl

curl --location 'https://api-preproduction.signzy.app/api/v3/itr/form-26-as-pull' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: <Auth Token>' \
--data-raw '{
"username": "*******",
"password": "*********",
"range": 3
}'

Input Parameters

Parameter	Type	Mandatory/Optional	Description
username	string	Mandatory	The username of the end-customer on the ITR Portal. It usually is the PAN of the user.
password	string	Conditional Mandatory	Password for the ITR portal of the PAN holder
sessionId	string	Conditional Mandatory	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.
range	number	Optional	The number of years for which data is being requested

Sample Response

{
    "username": "*******",
    "password": "*********",
    "sessionId": "itr_nRwgCsSEkZEFUyYrkBJd",
    "range": 3,
    "id": 2,
    "result": [
        {
            "assessmentYear": "2022-2023",
            "tdsData": [
                {
                    "srNo": 1,
                    "nameOfDeductor": "XXXX TIONAL LIMITED",
                    "totalAmountPaid": "66.00",
                    "totalTaxDeducted": ".00",
                    "totalTdsDeposited": ".00",
                    "tanOfDeductor": "DXXXX600E",
                    "section": "194",
                    "transactionDate": "27-Sep-2021",
                    "statusOfBooking": "U",
                    "dateOfBooking": "08-Nov-2021",
                    "remarks": "-",
                    "amountPaid": "66.00",
                    "taxDeducted": ".00",
                    "tdsDeposited": ".00"
                },
                {
                    "srNo": 1,
                    "nameOfDeductor": "ABC DEF PRIVATE LIMITED",
                    "totalAmountPaid": "13123.00",
                    "totalTaxDeducted": "1242.00",
                    "totalTdsDeposited": "12321.00",
                    "tanOfDeductor": "CAZXCA31",
                    "section": "192",
                    "transactionDate": "31-Mar-2022",
                    "statusOfBooking": "F",
                    "dateOfBooking": "29-May-2022",
                    "remarks": "-",
                    "amountPaid": "134321.00",
                    "taxDeducted": "134.00",
                    "tdsDeposited": "14332.00"
                },
                {
                    "srNo": 2,
                    "nameOfDeductor": "ABC DEF PRIVATE LIMITED",
                    "totalAmountPaid": "2354.00",
                    "totalTaxDeducted": "42314.00",
                    "totalTdsDeposited": "41234.00",
                    "tanOfDeductor": "CAZXCA31",
                    "section": "192",
                    "transactionDate": "28-Feb-2022",
                    "statusOfBooking": "F",
                    "dateOfBooking": "29-May-2022",
                    "remarks": "-",
                    "amountPaid": "123432.00",
                    "taxDeducted": "41234.00",
                    "tdsDeposited": "1423234.00"
                },
                {
                    "srNo": 3,
                    "nameOfDeductor": "ABC DEF PRIVATE LIMITED",
                    "totalAmountPaid": "123423.00",
                    "totalTaxDeducted": "44123423.00",
                    "totalTdsDeposited": "234.00",
                    "tanOfDeductor": "CAZXCA31",
                    "section": "192",
                    "transactionDate": "31-Jan-2022",
                    "statusOfBooking": "F",
                    "dateOfBooking": "29-May-2022",
                    "remarks": "-",
                    "amountPaid": "123432.00",
                    "taxDeducted": "1234.00",
                    "tdsDeposited": "41234.00"
                }
            ]
        },
        {
            "assessmentYear": "2021-2022",
            "tdsData": [
                {
                    "srNo": 1,
                    "nameOfDeductor": "ABC DEF PRIVATE LIMITED",
                    "totalAmountPaid": "13123.00",
                    "totalTaxDeducted": "1242.00",
                    "totalTdsDeposited": "12321.00",
                    "tanOfDeductor": "CAZXCA31",
                    "section": "192",
                    "transactionDate": "31-Mar-2021",
                    "statusOfBooking": "F",
                    "dateOfBooking": "29-May-2021",
                    "remarks": "-",
                    "amountPaid": "134321.00",
                    "taxDeducted": "134.00",
                    "tdsDeposited": "14332.00"
                },
                {
                    "srNo": 2,
                    "nameOfDeductor": "ABC DEF PRIVATE LIMITED",
                    "totalAmountPaid": "2354.00",
                    "totalTaxDeducted": "42314.00",
                    "totalTdsDeposited": "41234.00",
                    "tanOfDeductor": "CAZXCA31",
                    "section": "192",
                    "transactionDate": "28-Feb-2021",
                    "statusOfBooking": "F",
                    "dateOfBooking": "29-May-2021",
                    "remarks": "-",
                    "amountPaid": "123432.00",
                    "taxDeducted": "41234.00",
                    "tdsDeposited": "1423234.00"
                }
            ]
        },
        {
            "assessmentYear": "2020-2021",
            "tdsData": [
                {
                    "srNo": 1,
                    "nameOfDeductor": "ABC DEF PRIVATE LIMITED",
                    "totalAmountPaid": "13123.00",
                    "totalTaxDeducted": "1242.00",
                    "totalTdsDeposited": "12321.00",
                    "tanOfDeductor": "CAZXCA31",
                    "section": "192",
                    "transactionDate": "31-Mar-2020",
                    "statusOfBooking": "F",
                    "dateOfBooking": "29-May-2022",
                    "remarks": "-",
                    "amountPaid": "134321.00",
                    "taxDeducted": "134.00",
                    "tdsDeposited": "14332.00"
                },
                {
                    "srNo": 2,
                    "nameOfDeductor": "ABC DEF PRIVATE LIMITED",
                    "totalAmountPaid": "2354.00",
                    "totalTaxDeducted": "42314.00",
                    "totalTdsDeposited": "41234.00",
                    "tanOfDeductor": "CAZXCA31",
                    "section": "192",
                    "transactionDate": "28-Feb-2020",
                    "statusOfBooking": "F",
                    "dateOfBooking": "29-May-2022",
                    "remarks": "-",
                    "amountPaid": "123432.00",
                    "taxDeducted": "41234.00",
                    "tdsDeposited": "1423234.00"
                },
            ]
        }
    ]
}

Output Parameters

Parameter	Type	Description
username	string	The username provided in the input
password	string	The password provided in the input
id	number	Unique ID to identify the request
result	object	Entire result
result.[assessment-year]	object	Form 26AS details for given assessment year. eg. result[2022-23]
result.[tdsData]	object	JSON object of TDS

Status codes

CODE	MESSAGE
200	Request successful
409	Upstream is down
400	Incorrect Password, please try again

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected].