# M1_W2_RECORD

---
title: M1_W2_RECORD 
description:  The M1_W2_RECORD Schema represents the details of a W-2 tax form, which reports wages, tips, and other compensation paid to an employee. It includes information about the employee, employer, earnings, taxes withheld, and other payroll-related details for tax filing purposes.
---
The M1_W2_RECORD Schema represents the details of a W-2 tax form, which reports wages, tips, and other compensation paid to an employee. It includes information about the employee, employer, earnings, taxes withheld, and other payroll-related details for tax filing purposes.

{% json-schema
        schema={
    "type": "object",
    "properties": {
        "allocated_tips": {
            "type": "string",
            "description": "Tips allocated to the employee by the employer."
        },
        "employee": {
            "type": "object",
            "properties": {
                "address": {
                    "type": "object",
                    "properties": {
                        "zipcode": {
                            "type": "string",
                            "description": "Postal code of the employee's address."
                        },
                        "country": {
                            "type": "object",
                            "properties": {
                                "a2_code": {
                                    "type": "string",
                                    "description": "ISO 3166-1 alpha-2 country code."
                                },
                                "name": {
                                    "type": "string",
                                    "description": "Name of the country."
                                }
                            }
                        },
                        "addr2": {
                            "type": "string",
                            "description": "Additional address line."
                        },
                        "addr1": {
                            "type": "string",
                            "description": "Primary address line."
                        },
                        "city": {
                            "type": "string",
                            "description": "City of the employee's address."
                        },
                        "state": {
                            "type": "string",
                            "description": "State of the employee's address."
                        }
                    }
                },
                "gender": {
                    "type": "string",
                    "description": "Gender of the employee."
                },
                "prefix": {
                    "type": "string",
                    "description": "Prefix of the employee's name (e.g., Mr., Ms.)."
                },
                "date_of_birth": {
                    "type": "string",
                    "description": "Date of birth of the employee."
                },
                "last_name": {
                    "type": "string",
                    "description": "Last name of the employee."
                },
                "middle_name": {
                    "type": "string",
                    "description": "Middle name of the employee."
                },
                "suffix": {
                    "type": "string",
                    "description": "Suffix of the employee's name (e.g., Jr., Sr.)."
                },
                "ssn": {
                    "type": "string",
                    "description": "Social Security Number of the employee."
                },
                "marital_status": {
                    "type": "string",
                    "description": "Marital status of the employee."
                },
                "full_name": {
                    "type": "string",
                    "description": "Full name of the employee."
                },
                "nationality": {
                    "type": "string",
                    "description": "Nationality of the employee."
                },
                "phone_number": {
                    "type": "string",
                    "description": "Phone number of the employee."
                },
                "first_name": {
                    "type": "string",
                    "description": "First name of the employee."
                },
                "email": {
                    "type": "string",
                    "description": "Email address of the employee."
                }
            }
        },
        "social_security_tips": {
            "type": "string",
            "description": "Tips subject to Social Security tax."
        },
        "local_wages_tips": {
            "type": "string",
            "description": "Local wages and tips."
        },
        "control_number": {
            "type": "string",
            "description": "Control number assigned by the employer."
        },
        "federal_income_tax_withheld": {
            "type": "object",
            "properties": {
                "amount": {
                    "type": "number",
                    "description": "Amount of federal income tax withheld."
                },
                "currency": {
                    "type": "string",
                    "description": "Currency of the amount."
                }
            }
        },
        "medicare_tax_withheld": {
            "type": "object",
            "properties": {
                "amount": {
                    "type": "number",
                    "description": "Amount of Medicare tax withheld."
                },
                "currency": {
                    "type": "string",
                    "description": "Currency of the amount."
                }
            }
        },
        "employer": {
            "type": "object",
            "properties": {
                "address": {
                    "type": "object",
                    "properties": {
                        "zipcode": {
                            "type": "string",
                            "description": "Postal code of the employer's address."
                        },
                        "country": {
                            "type": "object",
                            "properties": {
                                "a2_code": {
                                    "type": "string",
                                    "description": "ISO 3166-1 alpha-2 country code."
                                },
                                "name": {
                                    "type": "string",
                                    "description": "Name of the country."
                                }
                            }
                        },
                        "addr2": {
                            "type": "string",
                            "description": "Additional address line."
                        },
                        "addr1": {
                            "type": "string",
                            "description": "Primary address line."
                        },
                        "city": {
                            "type": "string",
                            "description": "City of the employer's address."
                        },
                        "state": {
                            "type": "string",
                            "description": "State of the employer's address."
                        }
                    }
                },
                "name": {
                    "type": "string",
                    "description": "Name of the employer."
                },
                "phone_number": {
                    "type": "string",
                    "description": "Phone number of the employer."
                },
                "employer_id": {
                    "type": "string",
                    "description": "Employer identification number."
                }
            }
        },
        "box_13": {
            "type": "object",
            "properties": {
                "statutory_employee": {
                    "type": "boolean",
                    "description": "Indicates if the employee is a statutory employee."
                },
                "third_party_sick_pay": {
                    "type": "boolean",
                    "description": "Indicates if the employee received third-party sick pay."
                },
                "retirement_plan": {
                    "type": "boolean",
                    "description": "Indicates if the employee is part of a retirement plan."
                }
            }
        },
        "box_12": {
            "type": "array",
            "description": "Box 12 items, including codes and amounts."
        },
        "state": {
            "type": "string",
            "description": "State code for state wages and taxes."
        },
        "box_9": {
            "type": "string",
            "description": "Verification code for employment-based verification."
        },
        "dependent_care_benefits": {
            "type": "string",
            "description": "Dependent care benefits provided by the employer."
        },
        "box_14_other": {
            "type": "string",
            "description": "Other amounts reported in Box 14."
        },
        "record_year": {
            "type": "integer",
            "description": "Year for which the record is applicable."
        },
        "state_wages_tips": {
            "type": "object",
            "properties": {
                "amount": {
                    "type": "number",
                    "description": "Amount of state wages and tips."
                },
                "currency": {
                    "type": "string",
                    "description": "Currency of the amount."
                }
            }
        },
        "wages_tips_other_comp": {
            "type": "object",
            "properties": {
                "amount": {
                    "type": "number",
                    "description": "Amount of wages, tips, and other compensation."
                },
                "currency": {
                    "type": "string",
                    "description": "Currency of the amount."
                }
            }
        },
        "nonqualified_plans": {
            "type": "string",
            "description": "Nonqualified plans amount."
        },
        "social_security_wages": {
            "type": "object",
            "properties": {
                "amount": {
                    "type": "number",
                    "description": "Amount of wages subject to Social Security tax."
                },
                "currency": {
                    "type": "string",
                    "description": "Currency of the amount."
                }
            }
        },
        "social_security_tax_withheld": {
            "type": "object",
            "properties": {
                "amount": {
                    "type": "number",
                    "description": "Amount of Social Security tax withheld."
                },
                "currency": {
                    "type": "string",
                    "description": "Currency of the amount."
                }
            }
        },
        "locality_name": {
            "type": "string",
            "description": "Name of the locality for local wages and taxes."
        },
        "medicare_wages_and_tips": {
            "type": "object",
            "properties": {
                "amount": {
                    "type": "number",
                    "description": "Amount of wages and tips subject to Medicare tax."
                },
                "currency": {
                    "type": "string",
                    "description": "Currency of the amount."
                }
            }
        },
        "employer_state_id_number": {
            "type": "string",
            "description": "Employer's state identification number."
        },
        "state_income_tax": {
            "type": "object",
            "properties": {
                "amount": {
                    "type": "integer",
                    "description": "Amount of state income tax withheld."
                },
                "currency": {
                    "type": "string",
                    "description": "Currency of the amount."
                }
            }
        },
        "local_income_tax": {
            "type": "string",
            "description": "Amount of local income tax withheld."
        }
    }
}
/%}