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].