A W-2 form, also known as the Wage and Tax Statement, is an official document that employers in the United States are required to provide to their employees annually. It summarizes an employee's earnings and the taxes withheld from their paychecks over the course of the previous calendar year.

API Upload

The type parameter is w2_forms for the upload endpoint.


Field Descriptions:

The model automatically detects data such as:

Session NameField NameData TypeDescription
Basic InformationOMB NoStringOffice of Management and Budget Number.
Basic InformationYearNumberThe tax year to which the form corresponds.
Basic InformationEmployee SSNStringSocial Security Number (SSN) of the employee.
Basic InformationEmployer NameStringName of the employer.
Basic InformationEmployer AddressStringAddress of the employer.
Basic InformationEmployer Zip CodeStringZip code of the employer.
Basic InformationEmployer Identification NumberStringEmployer Identification Number (EIN).
Basic InformationControl NumberStringA unique control number associated with the form.
Basic InformationEmployee NameStringName of the employee.
Basic InformationEmployee AddressStringAddress of the employee.
Basic InformationEmployee Zip CodeStringZip code of the employee.
Basic InformationBox1 Wages Tips CompensationNumberAmount in Box 1 for wages, tips, and compensation.
Basic InformationBox2 Federal Income Tax WithheldNumberAmount in Box 2 for federal income tax withheld.
Basic InformationBox3 Social Security WagesNumberAmount in Box 3 for social security wages.
Basic InformationBox4 Social Security Tax WithheldNumberAmount in Box 4 for social security tax withheld.
Basic InformationBox5 Medicare Wages TipsNumberAmount in Box 5 for Medicare wages and tips.
Basic InformationBox6 Medicare Tax WithheldNumberAmount in Box 6 for Medicare tax withheld.
Basic InformationBox7 Social Security TipsNumberAmount in Box 7 for social security tips.
Basic InformationBox8 Allocated TipsNumberAmount in Box 8 for allocated tips.
Basic InformationBox9 Verification CodeStringVerification code associated with the form.
Basic InformationBox10 Dependent Care BenefitsNumberAmount in Box 10 for dependent care benefits.
Basic InformationBox11 Nonqualified PlansNumberAmount in Box 11 for nonqualified plans.
Basic InformationBox12a CodeStringCode in Box 12a.
Basic InformationBox12a AmountNumberAmount in Box 12a.
Basic InformationBox12b CodeStringCode in Box 12b.
Basic InformationBox12b AmountNumberAmount in Box 12b.
Basic InformationBox12c CodeStringCode in Box 12c.
Basic InformationBox12c AmountNumberAmount in Box 12c.
Basic InformationBox12d CodeStringCode in Box 12d.
Basic InformationBox12d AmountNumberAmount in Box 12d.
Basic InformationStatutory EmployeeBooleanIndicates if the employee is a statutory employee.
Basic InformationRetirement PlanBooleanIndicates if the employee is covered by a retirement plan.
Basic InformationThird party sick payBooleanIndicates if third-party sick pay is involved.
Basic InformationBox14 OthersNumberAmount in Box 14 for other information.
Basic InformationBox15 StateName PrimaryStringState name in Box 15, Primary.
Basic InformationBox15 StateIdNumber PrimaryStringState ID number in Box 15, Primary.
Basic InformationBox15 StateName SecondaryStringState name in Box 15, Secondary.
Basic InformationBox15 StateIdNumber SecondaryStringState ID number in Box 15, Secondary.
Basic InformationBox16 State Wages Tips PrimaryNumberState wages, tips, and compensation in Box 16, Primary.
Basic InformationBox16 State Wages Tips SecondaryNumberState wages, tips, and compensation in Box 16, Secondary.
Basic InformationBox17 State Income Tax PrimaryNumberState income tax in Box 17, Primary.
Basic InformationBox17 State Income Tax SecondaryNumberState income tax in Box 17, Secondary.
Basic InformationBox18 Local Wages Tips PrimaryNumberLocal wages, tips, and compensation in Box 18, Primary.
Basic InformationBox18 Local Wages Tips SecondaryNumberLocal wages, tips, and compensation in Box 18, Secondary.
Basic InformationBox19 Local Income Tax PrimaryNumberLocal income tax in Box 19, Primary.
Basic InformationBox19 Local Income Tax SecondaryNumberLocal income tax in Box 19, Secondary.
Basic InformationBox20 Locality Name PrimaryStringLocality name in Box 20, Primary.
Basic InformationBox20 Locality Name SecondaryStringLocality name in Box 20, Secondary.
ErrorError MessageStringError message, if any.

Version

  • 1.0.0

Sample

Sample JSON Output

{
    "data": {
            "Basic Information": {
                "OMB No": {
                    "value": "",
                    "position": [],
                    "confidence": 1.0,
                    "review_required": false
                },
                "Year": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Employee SSN": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Employer Name": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Employer Address": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Employer Zip Code": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Employer Identification Number": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Control Number": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Employee Name": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Employee Address": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Employee Zip Code": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box1 Wages Tips Compensation": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box2 Federal Income Tax Withheld": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box3 Social Security Wages": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box4 Social Security Tax Withheld": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box5 Medicare Wages Tips": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box6 Medicare Tax Withheld": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box7 Social Security Tips": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box8 Allocated Tips": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box9 Verification Code": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box10 Dependent Care Benefits": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box11 Nonqualified Plans": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box12a Code": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box12a Amount": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box12b Code": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box12b Amount": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box12c Code": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box12c Amount": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box12d Code": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box12d Amount": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Statutory Employee": {
                    "value": false,
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Retirement Plan": {
                    "value": false,
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Third party sick pay": {
                    "value": false,
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box14 Others": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box15 StateName Primary": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box15 StateIdNumber Primary": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box15 StateName Secondary": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box15 StateIdNumber Secondary": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box16 State Wages Tips Primary": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box16 State Wages Tips Secondary": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box17 State Income Tax Primary": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box17 State Income Tax Secondary": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box18 Local Wages Tips Primary": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box18 Local Wages Tips Secondary": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box19 Local Income Tax Primary": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box19 Local Income Tax Secondary": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box20 Locality Name Primary": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Box20 Locality Name Secondary": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                }
            },
            "Error": {
                "Error Message": {
                    "value": "",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                }
            }
        }
    }