Tax Return OCR API

4.8/5

(30+ reviews)

Tax return OCR API that reads income, tax and refund

Turn tax returns and tax notices, PDF, scan or phone photo, into structured JSON. Taxpayers, tax year, filing status, income, tax due and refund, each with a confidence score.

No credit card required

SOC 2 Type II & GDPR

Form 1040 tax return with adjusted gross income, wages and refund extracted to JSON with confidence scores

Trusted by finance and product teams at

Why tax returns slow down income checks

Lenders and landlords ask for the last two years of returns. Each runs to several pages of forms and schedules, so analysts hunt for wages, AGI and tax, then key them in by hand.

Returns uploaded

Applicant sends the last two years.

Manual keying

Wages, AGI and tax typed in.

Friction

Key lines hide among the schedules.

Income check

Figures compared with pay stubs.

Friction

Gaps surface late in underwriting.

Review

Year-on-year change checked by hand.

Friction

Two returns, dozens of pages each.

Decision

Finally ready for the credit decision.

RESULT

[X] minutes to key each tax return, and [X]% of applications delayed for a missing or misread figure.

See how Mindee fixes it

Return

form_type, tax_year, filing_status

Taxpayers

taxpayer_names, tax_id, dependents_count

Address

address.street, city, state, postal_code

Income

wages, total_income, adjusted_gross_income, taxable_income

Tax & payments

total_tax, tax_withheld, refund_amount, amount_owed

Filing

signature_date, preparer_name, occupation

response.json

{

"form_type": { "value": "Form 1040" }, "tax_year": { "value": 2025 }, "filing_status": { "value": "Married filing jointly" },

"taxpayer_names": [ { "value": "Daniel R. Hayes" }, { "value": "Laura M. Hayes" } ], "tax_id": { "value": "XXX-XX-4417" }, "dependents_count": { "value": 1 },

"address": { "street": { "value": "1418 Dock St" }, "city": { "value": "Wilmington" }, "state": { "value": "NC" }, "postal_code": { "value": "28401" } },

"wages": { "value": 92450.00 }, "adjusted_gross_income": { "value": 94330.00 }, "taxable_income": { "value": 62830.00 },

"total_tax": { "value": 4863.00 }, "tax_withheld": { "value": 6120.00 }, "refund_amount": { "value": 1257.00 },

"signature_date": { "value": "2026-03-14" }, "preparer_name": { "value": null }, "occupation": { "value": "Logistics manager" },

}

Ready to post, not just to read.

Fields come from a data schema you define in minutes. Amounts come back as numbers and the tax year as a year, each field with a confidence score.

Built for real tax returns, not blank forms

Forty-page PDFs with schedules and W-2s, scanned tax notices, a phone photo of last year's return. The model finds the income and tax lines wherever they sit and flags doubts.

Tax returns and tax notices from six countries mapped by Mindee to one tax return schema

Any country, any tax form

Form 1040, avis d'imposition, SA302 or notice of assessment: every return comes back in one schema you define, with no template per form.

Tax pack PDF split and classified into Form 1040, a schedule and two W-2 forms

Return, schedules and W-2s split

A full return PDF often bundles the 1040, its schedules and W-2s. Mindee splits the file and classifies each form before extraction.

Tax return income checked against W-2s, pay stubs and a loan application, with stated income flagged

Income checked against pay stubs

Wages and AGI come back as numbers, so the income on the return can be matched against pay stubs and bank statements without retyping.

Two years of Form 1040 returns compared side by side, with wages, AGI, tax and refund changes

Two tax years, side by side

Lenders ask for two years of returns. Each year comes back in the same fields, so the year-on-year change is computed, not keyed.

PDF / JPEG / PNG / WEBP / TIFF / HEIC, Form 1040 & schedules, Tax notices & assessments, Multi-year returns, Scans & phone photos

Tax return OCR accuracy, field by field

Every field comes with a confidence score, so clean returns flow straight into your income check and unclear lines go to an analyst. Test it on your own returns in the free trial.

99.4%

Field-level accuracy on header fields

Taxpayers, tax year, filing status

94.8%

Accuracy on income and tax lines

Wages, AGI, tax, refund

1.3s

Median time per page

Single page, synchronous call

A confidence score on every field

Set your own threshold. Fields above it flow straight to your systems; anything below lands in a review queue, with the exact spot on the tax return highlighted. Définissez votre propre seuil. Les champs au-dessus partent directement dans vos systèmes ; les autres rejoignent une file de vérification, avec leur emplacement exact mis en évidence sur votre tax return.

Auto-approve the tax returns you can trust Validez automatiquement les tax returns fiables

Send only real exceptions to a human

Document AI features, better than OCR

Prepare, classify and extract. Mindee delivers high-accuracy extraction for every document format, so you can automate workflows with speed and high reliability.

Prototype in minutes, go live with the API

Start with a no-code workflow to prove the value on your own tax returns, then move the same model into your product. Commencez par un workflow no-code pour prouver sa valeur sur vos propres tax returns, puis intégrez le même modèle dans votre produit.

What teams build with tax return OCR

The same API powers very different products. Here is where it usually starts.

Rated 4.8/5 by developers and operations teams

4.8

on G2

4.9

on Capterra

quote

I like the easiness and how to use it. Also the price model is very fair. Good with space for improvement

on Capterra

quote

Mindee is a software that helps us to convert all of our physical business data like bills, invoices, warranty cards, calendar, recipts received to us into a digital documents that can be stored in our drive and can be uploaded in different type of Excel sheets so that all the updates can be maintained and a proper analytics of transactions can be kept by the financial team

on G2

quote

Mindee is a web based tool that help us in scanning and reading different type of documents like identity cards, invoices, proposal plans etc and extract all the information with its AI and then it provides all the information and data associated with these documents a structured way.

on G2

FAQ about Mindee's Tax Return OCR API

Can't find what you're looking for? Our team answers within one business day.

About tax return OCR À propos de l’OCR pour les tax return

What is a Form 1040?

Form 1040 is the standard US individual income tax return filed with the IRS. It reports the taxpayer’s filing status and dependents, all sources of income (wages, interest, dividends, business income, capital gains, retirement distributions), adjustments, the adjusted gross income, deductions, taxable income, the tax owed, payments already made, and the resulting refund or balance due. Depending on the taxpayer’s situation, it comes with schedules such as Schedule C for self-employment income or Schedule E for rental income. Mindee extracts the key figures from Form 1040 and returns them as structured JSON, so they can be used directly in lending, accounting or financial planning workflows.

Where do you find the AGI on a tax return?

The adjusted gross income (AGI) is your total income minus certain adjustments, such as contributions to some retirement accounts, student loan interest or half of self-employment tax. On recent versions of Form 1040, it appears on line 11, but the line number has changed over the years. AGI is one of the most widely used figures on a tax return: lenders use it to assess income, and it determines eligibility for many tax credits and benefits. Mindee extracts the AGI as a dedicated field, whatever the tax year or the layout of the form, so you don’t need to know which line to look at.

How do lenders use tax returns to verify self-employed income?

Self-employed borrowers don’t have pay stubs, so lenders usually ask for their personal tax returns for the last one or two years, with the relevant schedules (such as Schedule C for sole proprietors, or K-1s for partners and S-corporation shareholders). Underwriters then analyze the net business income, add back certain non-cash expenses such as depreciation, and often average the income over two years, paying attention to any decline. Mindee extracts these figures from each return and schedule, so the income calculation can be prepared automatically, instead of being retyped from dozens of pages for each application.

What’s the difference between a tax return and a tax transcript?

A tax return is the complete document the taxpayer filed, with all its forms and schedules. A tax transcript is a summary of that return issued by the IRS, showing the key figures the IRS has on record. Lenders often obtain the transcript directly from the IRS, with the borrower’s consent, and compare it with the return the borrower provided, to confirm that the figures match and that the return hasn’t been altered. With Mindee, the key figures from both documents can be extracted and compared automatically, and any difference is flagged for review.

About Mindee

Is my data secured and protected during the conversion process?

Yes, your data is highly secured and protected during the entire conversion process. As an enterprise-grade OCR solution, Mindee takes data privacy very seriously. Here are the key security measures in place:

  • Certified compliance: Mindee's infrastructure is SOC 2 Type II certified and fully GDPR compliant, ensuring strict industry standards for data protection.
  • Encryption: All documents and extracted data are fully encrypted both in transit (during the API call) and at rest.
  • Data localization: You have control over where your data is processed, with the option to host and process your data on either EU or US servers.
  • Strict privacy: Mindee respects data confidentiality. Your processed documents are not shared with third parties, and your private data is not used to train global AI models.

In short, your sensitive documents are processed in a secure, isolated environment and remain completely under your control.

Is Mindee's OCR API free to use?

We provide a 14 days free trial so you can fully test any of our OCR models — no credit card required. After this, we offer different pricing tiers depending of the volume of pages processed and the features you might need. See the pricing page for more information.

What file formats are supported for JSON conversion?

The supported document formats are:

  • PDF (application/pdf) – While technically a document format rather than an image, it is natively supported for all extraction models.
  • JPEG / JPG (image/jpeg)
  • PNG (image/png) – Must be non-animated.
  • WebP (image/webp)
  • TIFF / TIF (image/tiff) – Both single-page and multi-page TIFFs are supported and processed similarly to PDFs.
  • HEIC (image/heic) – Apple's High-Efficiency Image Container format.

‍

📌 Important technical limitations to keep in mind:

To ensure the OCR pipeline runs smoothly and successfully returns your JSON, make sure your files adhere to the following constraints:

  • Maximum file size: 100 MB per file.
  • Maximum page count: Up to 200 pages per document.
  • File state: The files cannot be encrypted, and PDFs must not be password-protected.

Ready to stop retyping tax returns?

Build your tax return model from a sample in minutes and send your first document to the API, with a team of document processing engineers behind it.

14-day free trial

No credit card required