Form 26AS Extraction

Introduction

The Form 26AS Extraction API stands out as an innovative solution, meticulously designed to enhance the efficiency of extracting crucial tax-related information from Form 26AS PDF documents. Simply upload the document, and the API efficiently processes it, extracting all key details such as TDS, AIR(annual Information Return) Transaction details, Paid Refund, Tax Paid (excluding TDS or TCS), Tax Collected at Source, and Tax Deducted at Source for Immovable Property sales. This sophisticated approach ensures a comprehensive and streamlined extraction process.

API details

Endpoint

POST https://api.signzy.app/api/v3/form26as/extraction

POST https://api-preproduction.signzy.app/api/v3/form26as/extraction

Request headers

Name	Value	Required	Description
Content-Type	application/json	Mandatory	The type of content that the request body contains.
Authorization	XXXXXXXXXXXXXXX	Mandatory	An authentication token to authorize the request. Reach out to the Signzy support team to get one created.

Request body parameters

Parameter	Data Type	Description	Required
url	String	The URL of the Form26 document to be extracted.	Mandatory
dob	String	Date of birth of the individual. In format DD/MM/YYYY	Optional
version	String	Specifies the version of the response. "v1" works only on old ITR files and responds in the v1 response format. "v2" works on both old and new ITR files and responds in the v2 response format. The possible input values are: "v1" or "v2" By default, it will take "v1", if not specified. We recommend using the "v2" version while using the API.	Optional

{
    "url": "https://preproduction-persist.signzy.tech/api/files/40143657/download/XXXXXXXXX.pdf",
    "dob": "DD/MM/YYYY",
    "version": "v2"
}

Code samples

curl --location 'https://api-preproduction.signzy.app/api/v3/form26as/extraction' \
--header 'Authorization: <Your access token>' \
--header 'Content-Type: application/json' \
--data '{
    "url": "https://preproduction-persist.signzy.tech/api/files/5013560/download/XXXXXXXXX.pdf",
    "dob": "DD/MM/YYYY",
    "version": "v1"
}'

Response body parameters

Parameter	Data Type	Description
url	String	URL to the Form 26AS document.
dob	String	Date of birth of the assessee.
version	String	Specify the version of the response.
id	String	Unique ID for the request.
result	Object	Contains the result of the task.
result.pan	String	PAN (Permanent Account Number) of the assessee.
result.statusOfPan	String	Status of the PAN.
result.financialYear	String	The financial year for which the form is applicable.
result.assessmentYear	String	The assessment year for the form.
result.nameOfAssessee	String	Name of the assessee.
result.addressOfAssessee	String	Address of the assessee.
result.transactions	Object	Contains various types of transactions and their details.
result.transactions.a	Object	Details of Tax Deducted at Source.
result.transactions.a.description	String	Description of the transaction category.
result.transactions.a.transactions	Array of objects	Contains the transaction details within the category.
result.transactions.a.transactions.srNo	String	Serial number.
result.transactions.a.transactions.nameOfDeductor	String	Name of the deductor.
result.transactions.a.transactions.tanOfDeductor	String	TAN of deductor.
result.transactions.a.transactions.totalAmountPaidOrCreditedInInr	String	Total amount paid or credited in INR
result.transactions.a.transactions.totalTaxDeductedInInr	String	Total tax deducted in INR.
result.transactions.a.transactions.totalTDSDepositedInInr	String	Total Tax Deducted at Source (TDS) deposited in INR.
result.transactions.a1	Object	Details of Tax Deducted at Source for 15G / 15H.
result.transactions.a1.description	String	Description of the transaction category.
result.transactions.a1.transactions	Array of objects	Contains the transaction details within the category.
result.transactions.a1.transactions.srNo	String	Serial number.
result.transactions.a1.transactions.nameOfDeductor	String	Name of the deductor.
result.transactions.a1.transactions.tanOfDeductor	String	TAN of deductor.
result.transactions.a1.transactions.totalAmountPaidOrCreditedInInr	String	Total amount paid or credited in INR
result.transactions.a1.transactions.totalTaxDeductedInInr	String	Total tax deducted in INR.
result.transactions.a1.transactions.totalTDSDepositedInInr	String	Total Tax Deducted at Source (TDS) deposited in INR.
result.transactions.a2	Object	Details of Tax Deducted at Source on Sale of Immovable Property u/s 194IA/ TDS on Rent of Property u/s 194IB (For Seller/Landlord of Property)
result.transactions.a2.description	String	Description of the transaction category.
result.transactions.a2.transactions	Array of objects	Contains the transaction details within the category.
result.transactions.a2.transactions.srNo	String	Serial number.
result.transactions.a2.transactions.acknowledgementNumber	String	Acknowledgment number.
result.transactions.a2.transactions.nameOfDeductor	String	Name of the deductor.
result.transactions.a2.transactions.panOfDeductor	String	PAN of deductor.
result.transactions.a2.transactionDate	String	Transaction date in format
result.transactions.a2.totalTransactionAmountInInr	String	Total transaction amount in INR.
result.transactions.a2.transactions.totalTDSDepositedInInr	String	Total Tax Deducted at Source (TDS) deposited in INR.
result.transactions.b	Object	Details of Tax Collected at Source.
result.transactions.b.description	String	Description of the transaction category.
result.transactions.b.transactions	Array of objects	Contains the transaction details within the category.
result.transactions.b.transactions.srNo	String	Serial number.
result.transactions.b.transactions.nameOfCollector	String	Name of the Collector.
result.transactions.b.transactions.tanOfCollector	String	TAN of Collector.
result.transactions.b.transactions.totalAmountPaidOrDebitedInInr	String	Total amount paid or Debited in INR
result.transactions.b.transactions.totalTaxCollectedInInr	String	Total Tax collected in INR.
result.transactions.b.transactions.totalTCSDepositedInInr	String	Total TCS Deposited in INR.
result.transactions.c	Object	Details of Tax Paid (other than TDS or TCS).
result.transactions.c.description	String	Description of the transaction category.
result.transactions.c.transactions	Array of objects	Contains the transaction details within the category.
result.transactions.c.transactions.srNo	String	Serial number.
result.transactions.c.transactions.majorHead	String	Major head code representing the type of tax or fee.
result.transactions.c.transactions.minorHead	String	Minor head code for further categorization.
result.transactions.c.transactions.taxInInr	String	Amount of tax paid in INR.
result.transactions.c.transactions.surchargeInInr	String	Surcharge amount in INR.
result.transactions.c.transactions.educationCessInInr	String	Education Cess amount in INR.
result.transactions.c.transactions.others	String	Any other charges or fees included, in INR.
result.transactions.c.transactions.totalTaxInInr	String	Total amount of tax and additional charges in INR.
result.transactions.c.transactions.bsrCode	String	Bank branch's BSR code where the tax was deposited.
result.transactions.c.transactions.dateOfDeposit	String	Date on which the tax was deposited.
result.transactions.c.transactions.challanSerialNumber	String	Serial number of the tax deposit challan.
result.transactions.c.transactions.remarks	String	Remarks or notes related to the transaction.
result.transactions.d	Object	Details of Paid Refund.
result.transactions.d.description	String	Description of the transaction category.
result.transactions.d.transactions	Array of objects	Contains the transaction details within the category.
result.transactions.d.transactions.srNo	String	Serial number.
result.transactions.d.transactions.assessmentYear	String	The assessment year for which the details are applicable.
result.transactions.d.transactions.mode	String	Mode of transaction.
result.transactions.d.transactions.refundIssued	String	Information on whether a refund was issued.
result.transactions.d.transactions.natureOfRefund	String	The nature or reason for the refund.
result.transactions.d.transactions.amountOfRefundInInr	String	The amount of refund issued, in INR.
result.transactions.d.transactions.interestInInr	String	Interest amount, if any, in INR.
result.transactions.d.transactions.dateOfPayment	String	Date on which the payment or refund was made.
result.transactions.d.transactions.remarks	String	Any additional remarks or notes related to the entry.
result.transactions.e	Object	Details of AIR Transaction.
result.transactions.e.description	String	Description of the transaction category.
result.transactions.e.transactions	Array of objects	Contains the transaction details within the category.
result.transactions.e.transactions.srNo	String	Serial number.
result.transactions.e.transactions.typeOfTransaction	String	The type or category of the transaction.
result.transactions.e.transactions.nameOfAIRFiler	String	The name of the person or entity filing the Annual Information Return (AIR).
result.transactions.e.transactions.transactionDate	String	The date on which the transaction occurred.
result.transactions.e.transactions.singleOrJointPartyTransaction	String	Indicates whether the transaction involved a single party or multiple parties.
result.transactions.e.transactions.numberOfParties	String	The number of parties involved in the transaction.
result.transactions.e.transactions.amountInInr	String	The amount involved in the transaction, in INR.
result.transactions.e.transactions.mode	String	The mode of the transaction.
result.transactions.e.transactions.remarks	String	Any additional remarks or notes related to the transaction.
result.transactions.f	Object	Details of Tax Deducted at Source on Sale of Immovable Property u/s 194IA/ TDS on Rent of Property u/s 194IB (For Buyer/Tenant of Property)
result.transactions.f.description	String	Description of the transaction category.
result.transactions.f.transactions	Array of objects	Contains the transaction details within the category.
result.transactions.f.transactions.srNo	String	Serial number.
result.transactions.f.transactions.acknowledgementNumber	String	The unique acknowledgment number associated with the transaction.
result.transactions.f.transactions.nameOfDeductee	String	The name of the individual or entity from whom the tax was deducted (deductee).
result.transactions.f.transactions.panOfDeductee	String	Permanent Account Number (PAN) of the deductee.
result.transactions.f.transactions.transactionDate	String	The date on which the transaction was carried out.
result.transactions.f.transactions.totalTransactionAmountInInr	String	The total amount of the transaction in Indian Rupees (INR).
result.transactions.f.transactions.totalTDSDepositedInInr	String	The total amount of Tax Deducted at Source (TDS) deposited in INR.
result.transactions.f.transactions.totalAmountDepositedOtherThanTDSInInr	String	The total amount deposited other than TDS in INR.
result.transactions.g	Object	TDS Defaults (Processing of Statements)
result.transactions.g.description	String	Description of the transaction category.
result.transactions.g.transactions	Array of objects	Contains the transaction details within the category.
result.transactions.g.transactions.srNo	String	Serial number.
result.transactions.g.transactions.financialYear	String	The financial year related to the default or discrepancy.
result.transactions.g.transactions.shortPayment	String	Amount of tax payment shortfall, in INR.
result.transactions.g.transactions.shortDeduction	String	Amount of tax deduction shortfall, in INR.
result.transactions.g.transactions.interestOnTDSPaymentsDefaultInInr	String	Interest charged on default of TDS payments, in INR.
result.transactions.g.transactions.InterestOnTDSDeductionDefaultInInr	String	Interest charged on default of TDS deductions, in INR.
result.transactions.g.transactions.lateFillingFeeUS234EInInr	String	Late filing fee under section 234E, in INR.
result.transactions.g.transactions.interestUS220(2InInr)	String	Interest under section 220(2), in INR.
result.transactions.g.transactions.totalDefaultInInr	String	Total amount of default including all penalties and interests, in INR.

Parameter	Data Type	Description
url	String	URL to the Form 26AS document.
dob	String	Date of birth of the assessee.
version	String	Specify the version of the response.
id	String	Unique ID for the request.
result	Object	Contains the result of the task.
result.pan	String	PAN (Permanent Account Number) of the assessee.
result.statusOfPan	String	Status of the PAN.
result.financialYear	String	The financial year for which the form is applicable.
result.assessmentYear	String	The assessment year for the form.
result.nameOfAssessee	String	Name of the assessee.
result.addressOfAssessee	String	Address of the assessee.
result.transactions	Array of objects	Contains various types of transactions and their details.
result.transactions[].section	String	Category of transactions - as per ITR forms.
result.transactions[].description	String	Description of the transaction category.
result.transactions[].transactions	Array of objects	Contains the transaction details within the category.
result.transactions[].transactions[].srNo	String	Serial number.
result.transactions[].transactions[].nameOfDeductor	String	Name of the deductor.
result.transactions[].transactions[].tanOfDeductor	String	TAN of deductor.
result.transactions[].transactions[].totalAmountPaidOrCreditedInInr	String	The total amount paid or credited in INR
result.transactions[].transactions[].totalTaxDeductedInInr	String	Total tax deducted in INR.
result.transactions[].transactions[].totalTDSDepositedInInr	String	Total Tax Deducted at Source (TDS) deposited in INR.
... Other sections from ITR form in similar format as defined above. There might be some different fields in transactions based on the ITR blocks.

// When url is passed as empty string
    "error": {
        "statusCode": 400,
        "name": "Error",
        "message": "URL is not valid"
    }
}

// When wrong url is passed in request body
{
    "error": {
        "statusCode": 400,
        "name": "Error",
        "message": "Please pass a valid PDF file"
    }
}

// When url is not passed in PDF format
{
  "error": {
    "statusCode": 400,
    "name": "Error",
    "message": "Please pass a valid PDF file",
    "status": 400
  }
}

Only PDF documents are supported on this API.

Maximum 2MB size documents are supported on this API.

Contact Us for Any Assistance

If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!