Document Intelligence US tax document models

Important

• Document Intelligence public preview releases provide early access to features that are in active development.
• Features, approaches, and processes may change, prior to General Availability (GA), based on user feedback.
• The public preview version of Document Intelligence client libraries default to REST API version 2023-10-31-preview.

This content applies to: v4.0 (preview) | Previous versions: v3.1 (GA)

The Document Intelligence contract model uses powerful Optical Character Recognition (OCR) capabilities to analyze and extract key fields and line items from a select group of tax documents. Tax documents can be of various formats and quality including phone-captured images, scanned documents, and digital PDFs. The API analyzes document text; extracts key information such as customer name, billing address, due date, and amount due; and returns a structured JSON data representation. The model currently supports certain English tax document formats.

Supported document types:

• W-2
• 1098
• 1098-E
• 1098-T
• 1099 and variations (A, B, C, CAP, DIV, G, H, INT, K, LS, LTC, MISC, NEC, OID, PATR, Q, QA, R, S, SA, SB​)

Automated tax document processing

Automated tax document processing is the process of extracting key fields from tax documents. Historically, tax documents were processed manually. This model allows for the easy automation of tax scenarios.

Development options

Document Intelligence v4.0 (2023-10-31-preview) supports the following tools, applications, and libraries:

Feature	Resources	Model ID
US tax form models	• Document Intelligence Studio • REST API • C# SDK • Python SDK • Java SDK • JavaScript SDK	• prebuilt-tax.us.W-2 • prebuilt-tax.us.1098 • prebuilt-tax.us.1098E • prebuilt-tax.us.1098T • prebuilt-tax.us.1099(Variations)

Input requirements

• For best results, provide one clear photo or high-quality scan per document.

• Supported file formats:

  Model	PDF	Image: JPEG/JPG, PNG, BMP, TIFF, HEIF	Microsoft Office: Word (DOCX), Excel (XLSX), PowerPoint (PPTX), and HTML
  Read	✔	✔	✔
  Layout	✔	✔	✔ (2023-10-31-preview)
  General Document	✔	✔
  Prebuilt	✔	✔
  Custom	✔	✔

• For PDF and TIFF, up to 2000 pages can be processed (with a free tier subscription, only the first two pages are processed).

• The file size for analyzing documents is 500 MB for paid (S0) tier and 4 MB for free (F0) tier.

• Image dimensions must be between 50 x 50 pixels and 10,000 px x 10,000 pixels.

• If your PDFs are password-locked, you must remove the lock before submission.

• The minimum height of the text to be extracted is 12 pixels for a 1024 x 768 pixel image. This dimension corresponds to about 8-point text at 150 dots per inch (DPI).

• For custom model training, the maximum number of pages for training data is 500 for the custom template model and 50,000 for the custom neural model.

  • For custom extraction model training, the total size of training data is 50 MB for template model and 1G-MB for the neural model.

  • For custom classification model training, the total size of training data is 1GB with a maximum of 10,000 pages.

Try tax document data extraction

See how data, including customer information, vendor details, and line items, is extracted from invoices. You need the following resources:

• An Azure subscription—you can create one for free

• A Document Intelligence instance in the Azure portal. You can use the free pricing tier (F0) to try the service. After your resource deploys, select Go to resource to get your key and endpoint.

Document Intelligence Studio

1. On the Document Intelligence Studio home page, select the supported tax document model.

2. You can analyze a sample tax document or upload your own files.

3. Select the Run analysis button and, if necessary, configure the Analyze options :

   

Try Document Intelligence Studio

Supported languages and locales

See our Language Support—prebuilt models page for a complete list of supported languages.

Field extraction W-2

The following are the fields extracted from a W-2 tax form in the JSON output response.

Name	Type	Description	Example output
W-2FormVariant	String	IR W-2 Form variant. This field can have the one of the following values: W-2, W-2AS, W-2CM, W-2GU, or W-2VI	W-2
TaxYear	Number	Form tax year	2021
W2Copy	String	W-2 tax copy version along with printed instruction related to this copy	Copy A—For Social Security Administration
Employee	object	Object that contains social security number, name, and address
ControlNumber	string	W-2 control number. IRS W-2 field d	0AB12 D345 7890
Employer	Object	Object that contains employer identification number, name and address
WagesTipsAndOtherCompensation	Number	Wages, tips, and other compensation amount in USD. IRS W-2 field 1	1234567.89
FederalIncomeTaxWithheld	Number	Federal income tax withheld amount in USD. IRS W-2 field 2	1234567.89
SocialSecurityWages	Number	Social security wages amount in USD. IRS W-2 field 3	1234567.89
SocialSecurityTaxWithheld	Number	Social security tax withheld amount in USD. IRS W-2 field 4	1234567.89
MedicareWagesAndTips	Number	Medicare wages and tips amount in USD. IRS W-2 field 5	1234567.89
MedicareTaxWithheld	Number	Medicare tax withheld amount in USD. IRS W-2 field 6	1234567.89
SocialSecurityTips	Number	Social security tips amount in USD. IRS W-2 field 7	1234567.89
AllocatedTips	Number	Allocated tips in USD. IRS W-2 field 8	1234567.89
VerificationCode	Number	W-2 verification code. IRS W-2 field 9	1234567.89
DependentCareBenefits	Number	Dependent care benefits amount in USD. IRS W-2 field 10	1234567.89
NonQualifiedPlans	Number	Non qualified plans amount in USD. IRS W-2 field 11	1234567.89
IsStatutoryEmployee	String	Part of IRS W-2 field 13. Can be 'true' or 'false'	true
IsRetirementPlan	String	Part of IRS W-2 field 13. Can be 'true' or 'false'	true
IsThirdPartySickPay	String	Part of IRS W-2 field 13. Can be 'true' or 'false'	true
Other	String	Content of IRS W-2 field 14	SICK LV WAGES SBJT TO $511/DAY LIMIT 1356
StateTaxInfos	Array	State tax-related information. content of IRS W-2 field 15 to 17
LocaleTaxInfos	Array	Local tax-related information. Content of IRS W-2 field 18 to 20

Field extraction 1098

The following are the fields extracted from a 1098 tax form in the JSON output response. The 1098-T and 1098-E forms are also supported.

Name	Type	Description	Example output
TaxYear	Number	Form tax year	2021
Borrower	Object	An object that contains the borrower's TIN, Name, Address, and AccountNumber
Lender	Object	An object that contains the lender's TIN, Name, Address, and Telephone
MortgageInterest	Number	Mortgage Interest amount received from payer(s)/borrower(s) (box 1)	1,234,567.89
OutstandingMortgagePrincipal	Number	Outstanding mortgage principal (box 2)	1,234,567.89
MortgageOriginationDate	Date	Origination date of the mortgage (box 3)	2022-01-01
OverpaidInterestRefund	Number	Refund amount of overpaid interest (box 4)	1,234,567.89
MortgageInsurancePremium	Number	Mortgage insurance premium amount (box 5)	1,234,567.89
PointsPaid	Number	Points paid on purchase of principal residence (Box 6)	1,234,567.89
IsPropertyAddressSameAsBorrower	String	Is the address of the property securing the mortgage the same as the payer's/borrower's mailing address (box 7)	true
PropertyAddress	String	Address or description of the property securing the mortgage (box 8)	123 Main St., Redmond WA 98052
MortgagedPropertiesCount	Number	Number of mortgaged properties (box 9)	1
Other	String	Additional information to report to payer (box 10)
RealEstateTax	Number	Real estate tax (box 1)	1,234,567.89
AdditionalAssessment	String	Added assessments made on the property (box 10)	1,234,567.89
MortgageAcquisitionDate	date	Mortgage acquisition date (box 11)	2022-01-01

Field extraction 1099-NEC

The following are the fields extracted from a 1099-nec tax form in the JSON output response. The other variations of 1099 are also supported.

Name	Type	Description	Example output
TaxYear	String	Tax Year extracted from Form 1099-NEC.	2021
Payer	Object	An object that contains the payer's TIN, Name, Address, and PhoneNumber
Recipient	Object	An object that contains the recipient's TIN, Name, Address, and AccountNumber
Box1	number	Box 1 extracted from Form 1099-NEC.	123456
Box2	boolean	Box 2 extracted from Form 1099-NEC.	true
Box4	number	Box 4 extracted from Form 1099-NEC.	123456
StateTaxesWithheld	array	State Taxes Withheld extracted from Form 1099-NEC (boxes 5, 6, and 7)

The tax documents key-value pairs and line items extracted are in the documentResults section of the JSON output.

Next steps

• Try processing your own forms and documents with the Document Intelligence Studio

• Complete a Document Intelligence quickstart and get started creating a document processing app in the development language of your choice.