Skip to main content

Get a W-2

GET 
/api/v8/partner/w2s/:document_id

Veryfi's Get a W-2 endpoint allows you to retrieve a previously processed W-2.

Request​

Path Parameters

    document_id int64required

    The unique identifier of the document.

Responses​

The processed W-2.

Schema
    pdf_url urirequired

    Possible values: non-empty and <= 2083 characters

    A signed URL to access the auto-generated PDF created from the submitted document. This URL expires 15 minutes after the response object is returned and is resigned during every GET request.

    id integerrequired

    The unique number created to identify the document.

    advance_eic_payment number

    The total amount of any Earned Income Credit (EIC) payment found in Box 9 of the W-2.

    employee_ssn string

    The Social Security Number (SSN) found in Box A of the W-2.

    ein string

    The Employer Identification Number (EIN) found in Box B of the W-2.

    employer_name string

    The employer name found in Box C of the W-2.

    employer_address string

    The employer address found in Box C of the W-2.

    control_number string

    The control number found in Box D of the W-2.

    employee_name string

    The full name of the employee found in Box E of the W-2.

    employee_address string

    The address of the employee found in Box F of the W-2.

    wages_other_comps number

    The total taxable income paid found in Box 1 of the W-2.

    federal_income_tax number

    The total amount of federal income tax withheld found in Box of the W-2.

    ss_wages number

    The total wages subject to social security tax found in Box 3 of the W-2.

    ss_tax number

    The amount of social security tax withheld found in Box 4 of the W-2.

    medicare_wages number

    The total wages, tips and other compensation that are subject to Medicare taxes found in Box 5 of the W-2.

    medicare_tax number

    The amount of Medicare tax withheld from your Medicare taxable wages, tips and other compensation found in Box 6 of the W-2.

    ss_tips number

    The amount of earned money through tips found in Box 7 of the W-2.

    allocated_tips number

    The amount the employer allocated to tips found in Box 8 of the W-2.

    dependent_care_benefits number

    The amount the employer provided or paid for dependent care benefits found in Box 10 of the W-2.

    non_qualified_plans number

    The amount of retirement savings the employer sponsored and is tax deferred found in Box 11 of the W-2.

    state string

    The two-letter code representing the state found in Box 15 of the W-2. For example, California would be CA.

    employer_state_id string

    The employer identification number found in Box 15 of the W-2.

    state_wages_tips number

    The employer identification number found in Box 15 of the W-2.

    state_income_tax number

    The total state income taxes that were withheld found in Box 17 of the W-2.

    local_wages_tips number

    The total local taxable gross pay found in Box 18 of the W-2.

    local_income_tax number

    The total local income tax withheld found in Box 19 of the W-2.

    locality_name string

    The locality name found in Box 20 of the W-2.

    field_12a_col1 string

    The name of another type of compensation or reduction to taxable income found in Box 12 of the W-2. For example, health savings account contributions, group life insurance, 403(b) contributions, and more.

    field_12a_col2 number

    The amount for other types of compensations or reduction to taxable income found in Box 12 of the W-2.

    field_12b_col1 string

    The name of another type of compensation or reduction to taxable income found in Box 12 of the W-2. For example, health savings account contributions, group life insurance, 403(b) contributions, and more.

    field_12b_col2 number

    The amount for other types of compensations or reduction to taxable income found in Box 12 of the W-2.

    field_12c_col1 string

    The name of another type of compensation or reduction to taxable income found in Box 12 of the W-2. For example, health savings account contributions, group life insurance, 403(b) contributions, and more.

    field_12c_col2 number

    The amount for other types of compensations or reduction to taxable income found in Box 12 of the W-2.

    field_12d_col1 string

    The name of another type of compensation or reduction to taxable income found in Box 12 of the W-2. For example, health savings account contributions, group life insurance, 403(b) contributions, and more.

    field_12d_col2 number

    The amount for other types of compensations or reduction to taxable income found in Box 12 of the W-2.

    is_13a boolean

    A checkbox field representing if the individual worked as a statutory employee found in Box 13 of the W-2.

    is_13b boolean

    A checkbox field representing if the individual participated in an employer sponsored retirement plan found in Box 13 of the W-2.

    is_13c boolean

    A checkbox field representing if the individual received sick pay through a third party source found in Box 13 of the W-2.

    states object[]required

    A collection of objects that represent state employer id, wages, tips, and more found in Box 15 - 20 of the W-2.

  • Array [
    • state string

    The two-letter code representing the state found in Box 15 of the W-2. For example, California would be CA.

    employer_state_id string

    The employer identification number found in Box 15 of the W-2.

    state_wages_tips number

    The total state taxable gross pay found in Box 16 of the W-2.

    state_income_tax number

    The total state income taxes that were withheld found in Box 17 of the W-2.

    local_wages_tips number

    The total local taxable gross pay found in Box 18 of the W-2.

    local_income_tax number

    The total local income tax withheld found in Box 19 of the W-2.

    locality_name object

    The locality name found in Box 20 of the W-2.

    anyOf

    string

  • ]
    • field_14_other object[]required

    An object representing any other tax information that doesn't fit into other W-2 Boxes. For example, this field can be auto allowance, social club membership, travel reimbursement, and more.

  • Array [
    • column_1 string

    This field is used for any other tax information that doesn't fit into other W-2 Boxes. For example, this field can be auto allowance, social club membership, travel reimbursement, and more.

    column_2 number

    The value for the additional tax information.

  • ]
Loading...