Skip to content

Form 16 OCR API

New

Read a Form 16 and get the certificate number, employer and TAN, employee, masked PANs, assessment year, period, gross salary and total tax deducted as structured fields.

Overview

Form 16 OCR reads the TDS certificate an employer issues for salary and returns its key details as structured fields. The response carries the certificate number, the employer name and TAN, the employer and employee PANs (masked), the employee name, the assessment year, the period of employment, the gross salary and the total tax deducted. Form 16 is the employer's annual statement of salary and tax deducted. It is a stronger income document than a payslip for a full year, and lenders often ask for the last two.

Coverage
Form 16 TDS certificates for salary issued by employers in India
Input
A Form 16 image or PDF uploaded by the applicant, with consent
Output
Certificate number, employer name, TAN and masked PAN, employee name and masked PAN, assessment year, period, gross salary and total tax deducted
Typical users
Home loan, personal loan, tax filing and HR teams
Coverage note
Reads the printed certificate; it does not check the underlying tax records

The overview and the sections after the reference are the FinSour API catalog’s own record for this service, rendered unaltered.

Reference in progress

The request and response reference for this endpoint is not published yet.

Everything below this block is the live catalog record for this service, and it is accurate. The platform’s published API contract does not include this service yet, so there is no request or response detail to document. Rather than fill these sections with a plausible example, the page lists what is missing:

Endpoint URL and method
The host, path and HTTP verb for this service.
Authentication
How a request identifies itself, and where credentials come from.
Request parameters
Field names, types, which are required, and validation rules.
Response schema
The success body, field by field, with a real example.
Error codes
What each failure means and which are worth retrying.
Rate limits
Request ceilings, and what happens at the ceiling.

No sample payload, URL, response body, error code, rate limit or latency figure appears anywhere on this site unless it has been supplied and attributed. Each item in this list is removed only when its own detail arrives; none of them is held back to wait for the rest, and none is ever placed beside a guess in the meantime.

Use cases

  • Home loans: reading annual salary and tax deducted for eligibility
  • Personal lending: confirming income across a full year
  • Tax filing: prefilling salary and TDS details in a return
  • Lateral hiring: reading a previous employer's certificate
  • Income reconciliation: comparing Form 16 with payslips and bank credits

What this service does

  • The annual figures

    Gross salary and total tax deducted come back as decimal rupees in text, with the assessment year and the period of employment.

  • Who issued it, and to whom

    The certificate number, employer name and TAN, and employee name are returned, with both PANs masked.

  • The right year, checked early

    The assessment year and period are fields, so an old certificate can be caught at upload.

  • A reading, not a tax record check

    OCR reports what the certificate says. Read it with other income evidence where the decision needs assurance.

How a check runs

  1. Arrange access

    Tell us where Form 16 OCR fits in your process. We arrange access for your organization under the applicable service contract, which also sets the file formats and sizes you can send.

  2. Upload the certificate with consent

    The applicant uploads the Form 16. Your request names the file and records the consent you took for this purpose.

  3. Let the reading run

    The request is accepted with a job reference and read in the background.

  4. Collect the figures

    Collect the certificate details, year, period, gross salary and tax deducted by the job reference, with any fields to review.

  5. Compare and decide

    Compare the figures with payslips and bank statements, send mismatches for review, then use the confirmed income.

Questions

What is a Form 16 OCR API?
An interface that reads a Form 16 TDS certificate and returns its certificate number, employer and employee details, assessment year, period, gross salary and tax deducted as structured fields.
Does it return the employer TAN?
Yes, where the certificate prints it. The employer and employee PANs are returned masked.
Which assessment years can it read?
It reads the assessment year printed on the certificate and returns it in the form 2025-26. Layouts change over the years, so an older certificate may return more fields for review.
Does Form 16 OCR verify the tax was deposited?
No. It reads what the certificate says. It does not check the tax records the certificate refers to.
Do I need consent to read a Form 16?
Yes. It carries personal income and tax data. Take consent for the stated purpose, send it with the request, and retain the file only as your policy allows.
Should I read Form 16 or payslips?
Both answer different questions. Form 16 gives a full year of salary and tax. Payslips give recent months. Lenders often read both and compare them.

Catalog entry last updated .