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.
- Category
- Document OCR APIs
- 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
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.
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.
Let the reading run
The request is accepted with a job reference and read in the background.
Collect the figures
Collect the certificate details, year, period, gross salary and tax deducted by the job reference, with any fields to review.
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 .