Version: 2.0.0

Update

Updates the existing Form W-2C return created in TaxBandits. Use the unique identifiers to refer to a particular return, payer, or recipient. You can not update a return that is already Transmitted.

PUT formw2c/update

Run in Postman

Request Body

Field	Type	Description
SubmissionManifest	object[]	SubmissionManifest provides brief information about a particular submission on the whole.
SubmissionId	Guid	Unique identifier created by TaxBandits for each submission.
TaxYear	string	Tax year of Form W-2C to be filed. Allowed values "2025", "2026"
ReturnHeader	object	Contains information about the Business details.
Business	object	Object to identify the Business Details.
BusinessId	Guid	Optional Use the unique Business ID (Generated by TaxBandits) that you received in the response of the Business CREATE Endpoint. If you do not have a Business ID, ignore the field. By giving the Business ID, you do not have to provide all the business information again.
PayerRef	string	Optional Your unique identifier for the payer. Can replace BusinessId in future requests. Size Range: 50
IsDefaultBusiness	Boolean	When set to TRUE, this business will be set as the default across requests that do not specify a business.
TINDetails	object	TIN information for the business.
Format	string	Specifies how the TIN is passed. Allowed values "PLAIN_TIN" — Pass TIN directly. "TOKENIZED_TIN" - Pass tokenized TIN.
TINType	string	Specify the TIN type of the business. Allowed values "EIN"
TIN	string	The TIN value according to the Format selected.
IndividualNm	object	Required when TINType is SSN. Provide individual name fields instead of BusinessNm.
FirstNm	string	The first name of the individual. Size Range: 20
MiddleNm	string	Optional Middle name of the individual. Size Range: 20
LastNm	string	The last name of the individual. Size Range: 20
Suffix	string	Optional Suffix of the individual's name. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
BusinessNm	string	Legal name of the business. Required when TINType is EIN. Size Range: 75
NameCtrl	string	Name control of the business as registered with the IRS. Size Range: 3..4
DBADetails	object[]	Optional DBA (Doing Business As) information.
DBANm	string	Name of the DBA. Size Range: 75
DBARef	string	Unique identifier for the DBA. Size Range: 1-50
DBAId	Guid	TaxBandits-generated DBA identifier.
Address	object[]	Address information of the DBA.
Address1	string	Street address or PO Box. Size Range: 46
Address2	string	Optional Suite or apartment number. Size Range: 46
City	string	DBA's city. Size Range: 50
ProvinceOrState	string	DBA's province or state name. Allowed values When the country code is US: Allowed values "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP" When the country code is CA: Allowed values "AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" Note: The size range is set to 50 for all countries except the United States and Canada.
Zipcd	string	DBA's ZIP code. Size Range: 5-16
Country	string	DBA's 2-character country code. Allowed values "US","AF", "AX", "AL", "AG", "AQ", "AN", "AO", "AV", "AY", "AC", "AR", "AM", "AA", "AT", "AS", "AU", "AJ", "BF", "BA", "FQ", "BG", "BB", "BO", "BE", "BH", "BN", "BD", "BT", "BL", "BK", "BC", "BV", "BR", "IO", "VI", "BX", "BU", "UV", "BM", "BY", "CB", "CM", "CA", "CV", "CJ", "CT", "CD", "CI", "CH", "KT", "IP", "CK", "CO", "CN", "CF", "CG", "CW", "CR", "CS", "IV", "HR", "CU", "UC", "CY", "EZ", "DA", "DX", "DJ", "DO", "DR", "TT", "EC", "EG", "ES", "EK", "ER", "EN", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "FP", "FS", "GB", "GA", "GG", "GM", "GH", "GI", "GR", "GL", "GJ", "GQ", "GT", "GK", "GV", "PU", "GY", "HA", "HM", "VT", "HO", "HK", "HQ", "HU", "IC", "IN", "ID", "IR", "IZ", "EI", "IS", "IT", "JM", "JN", "JA", "DQ", "JE", "JQ", "JO", "KZ", "KE", "KQ", "KR", "KN", "KS", "KV", "KU", "KG", "LA", "LG", "LE", "LT", "LI", "LY", "LS", "LH", "LU", "MC", "MK", "MA", "MI", "MY", "MV", "ML", "MT", "IM", "RM", "MR", "MP", "MX", "MQ", "MD", "MN", "MG", "MJ", "MH", "MO", "MZ", "WA", "NR", "BQ", "NP", "NL", "NC", "NZ", "NU", "NG", "NI", "NE", "NF", "CQ", "NO", "MU", "OC", "PK", "PS", "LQ", "PM", "PP", "PF", "PA", "PE", "RP", "PC", "PL", "PO", "RQ", "QA", "RO", "RS", "RW", "TB", "RN", "WS", "SM", "TP", "SA", "SG", "RI", "SE", "SL", "SN", "NN", "LO", "SI", "BP", "SO", "SF", "SX", "OD", "SP", "PG", "CE", "SH", "SC", "ST", "SB", "VC", "SU", "NS", "SV", "WZ", "SW", "SZ", "SY", "TW", "TI", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TX", "TK", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI"
Address	object	Primary address of the business.
Address1	string	Street address or PO Box of the business. Size Range: 46
Address2	string	Optional Suite or apartment number of the business. Size Range: 46
City	string	City of the business. Size Range: 50
ProvinceOrState	string	Province or state name of the business. Allowed values When the country code is US: Allowed values "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP" When the country code is CA: Allowed values "AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" Note: The size range is set to 50 for all countries except the United States and Canada.
ZipCd	string	ZIP code of the business. Size Range: 5-16
Country	string	2-character country code of the business. Allowed values "US","AF", "AX", "AL", "AG", "AQ", "AN", "AO", "AV", "AY", "AC", "AR", "AM", "AA", "AT", "AS", "AU", "AJ", "BF", "BA", "FQ", "BG", "BB", "BO", "BE", "BH", "BN", "BD", "BT", "BL", "BK", "BC", "BV", "BR", "IO", "VI", "BX", "BU", "UV", "BM", "BY", "CB", "CM", "CA", "CV", "CJ", "CT", "CD", "CI", "CH", "KT", "IP", "CK", "CO", "CN", "CF", "CG", "CW", "CR", "CS", "IV", "HR", "CU", "UC", "CY", "EZ", "DA", "DX", "DJ", "DO", "DR", "TT", "EC", "EG", "ES", "EK", "ER", "EN", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "FP", "FS", "GB", "GA", "GG", "GM", "GH", "GI", "GR", "GL", "GJ", "GQ", "GT", "GK", "GV", "PU", "GY", "HA", "HM", "VT", "HO", "HK", "HQ", "HU", "IC", "IN", "ID", "IR", "IZ", "EI", "IS", "IT", "JM", "JN", "JA", "DQ", "JE", "JQ", "JO", "KZ", "KE", "KQ", "KR", "KN", "KS", "KV", "KU", "KG", "LA", "LG", "LE", "LT", "LI", "LY", "LS", "LH", "LU", "MC", "MK", "MA", "MI", "MY", "MV", "ML", "MT", "IM", "RM", "MR", "MP", "MX", "MQ", "MD", "MN", "MG", "MJ", "MH", "MO", "MZ", "WA", "NR", "BQ", "NP", "NL", "NC", "NZ", "NU", "NG", "NI", "NE", "NF", "CQ", "NO", "MU", "OC", "PK", "PS", "LQ", "PM", "PP", "PF", "PA", "PE", "RP", "PC", "PL", "PO", "RQ", "QA", "RO", "RS", "RW", "TB", "RN", "WS", "SM", "TP", "SA", "SG", "RI", "SE", "SL", "SN", "NN", "LO", "SI", "BP", "SO", "SF", "SX", "OD", "SP", "PG", "CE", "SH", "SC", "ST", "SB", "VC", "SU", "NS", "SV", "WZ", "SW", "SZ", "SY", "TW", "TI", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TX", "TK", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI"
ContactDetails	object[]	Details of the person the IRS can contact regarding the given business.
FirstNm	string	First name of the contact person. Size Range: 20
MiddleNm	string	Optional Middle name of the contact person. Size Range: 20
LastNm	string	Last name of the contact person. Size Range: 20
Suffix	string	Optional The suffix of the contact person. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
Phone	string	Optional Phone number of the contact person. Size Range: 10 digits
PhoneExtn	string	Optional Phone extension number. Size Range: 5
Fax	string	Optional Fax number of the contact person. Size Range: 10 digits
ReturnData	object[]	Contains information about the employee details and Form W-2C details.
SequenceId	string	A unique reference ID for the submission that can be used to identify a particular record. The Sequence ID will be returned in the Response for your reference. Size Range: 50
RecordId	string	A unique identifier of the record
ReturnManifest	object[]	Return Manifest provides a high-level summary of a return. It includes information such as the federal filing, state filing, postal service, employee copy distribution configuration, correction type associated with the return.
IsFederal	Boolean	Federal Filing for the return will be enabled when the value is True. Form W2-C will be sent directly to the SSA.
IsState	Boolean	State Filing for the return will be enabled when the value is True. Form W2-C will be directly filed with the respective employee states. Note: State Filing will not be created for the states that do not require State filing.
IsDistribution	Boolean	When TRUE, employee distribution is enabled (postal mail / online access/email).
DistributionDetails	object	Employee distribution configuration. Required when IsDistribution is TRUE.
DistributionType	string	Employee copy distribution type. Allowed values "POSTAL_ONLY", "ONLINE_ACCESS", "POSTAL_AND_ONLINE"
PostalType	string	Postal service type. Allowed values "USPS_FIRST_CLASS"
CorrectionDetails	object	Object containing the information required to identify the correction type for the Form W-2C return
PrevReportedRecordId	Guid	If you are correcting a W-2C that was originally filed with TaxBandits, provide the Record ID of the original Form W-2C here. The PrevReportedemployeeData Object is not required if you provide the PrevReportedRecordID
IsEmployeeSSNNameCorrection	Boolean	When True, Identifies that you are correcting the SSN or Name of the employee.
PrevReportedemployeeData	object	Object containing the employeeinformation that was submitted in the Original Form W2-C. The information is not required if you have provided the PrevReportedRecordId.
EmployeeId	Guid	Optional A unique ID generated by TaxBandits after the employee is created and will be returned in the Response.
PayeeRef	string	Optional Your unique identifier for the employee. Size Range: 50
TINDetails	object	Employee TIN information.
Format	string	Specifies how the TIN is passed. Allowed values "PLAIN_TIN" — Pass TIN directly. "TOKENIZED_TIN" - Pass tokenized TIN.
TINType	string	Specify the TIN type of the employee. Allowed values "SSN"
TIN	string	TIN value according to the Format selected.
IndividualNm	object	Required when TINType is SSN, ITIN, or ATIN. Provide individual name fields instead of BusinessNm.
FirstNm	string	The first name of the individual. Size Range: 20
MiddleNm	string	Optional The middle name of the individual. Size Range: 20
LastNm	string	The last name of the individual. Size Range: 20
Suffix	string	Optional The suffix of the individual's name. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
BusinessNm	string	Legal name of the employee business. Required when TINType is EIN. Size Range: 75
NameCtrl	string	Name control of the business as registered with the IRS. Size Range: 3..4
DBADetails	object	Optional DBA (Doing Business As) information.
DBAId	Guid	TaxBandits-generated DBA identifier. Returned in the response.
DBANm	string	Name of the DBA. Size Range: 75
DBARef	string	Your unique identifier for this DBA. Size Range: 1–50
Address	object	Address information of the DBA.
Address1	string	Street address or PO Box. Size Range: 46
Address2	string	Optional Suite or apartment number. Size Range: 46
City	string	DBA's city. Size Range: 50
ProvinceOrState	string	DBA's province or state name. Allowed values When the country code is US: Allowed values "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP" When the country code is CA: Allowed values "AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" Note: The size range is set to 50 for all countries except the United States and Canada.
ZipCd	string	DBA's ZIP code. Size Range: 5–16
Country	string	DBA's 2-character country code. Allowed values "US","AF", "AX", "AL", "AG", "AQ", "AN", "AO", "AV", "AY", "AC", "AR", "AM", "AA", "AT", "AS", "AU", "AJ", "BF", "BA", "FQ", "BG", "BB", "BO", "BE", "BH", "BN", "BD", "BT", "BL", "BK", "BC", "BV", "BR", "IO", "VI", "BX", "BU", "UV", "BM", "BY", "CB", "CM", "CA", "CV", "CJ", "CT", "CD", "CI", "CH", "KT", "IP", "CK", "CO", "CN", "CF", "CG", "CW", "CR", "CS", "IV", "HR", "CU", "UC", "CY", "EZ", "DA", "DX", "DJ", "DO", "DR", "TT", "EC", "EG", "ES", "EK", "ER", "EN", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "FP", "FS", "GB", "GA", "GG", "GM", "GH", "GI", "GR", "GL", "GJ", "GQ", "GT", "GK", "GV", "PU", "GY", "HA", "HM", "VT", "HO", "HK", "HQ", "HU", "IC", "IN", "ID", "IR", "IZ", "EI", "IS", "IT", "JM", "JN", "JA", "DQ", "JE", "JQ", "JO", "KZ", "KE", "KQ", "KR", "KN", "KS", "KV", "KU", "KG", "LA", "LG", "LE", "LT", "LI", "LY", "LS", "LH", "LU", "MC", "MK", "MA", "MI", "MY", "MV", "ML", "MT", "IM", "RM", "MR", "MP", "MX", "MQ", "MD", "MN", "MG", "MJ", "MH", "MO", "MZ", "WA", "NR", "BQ", "NP", "NL", "NC", "NZ", "NU", "NG", "NI", "NE", "NF", "CQ", "NO", "MU", "OC", "PK", "PS", "LQ", "PM", "PP", "PF", "PA", "PE", "RP", "PC", "PL", "PO", "RQ", "QA", "RO", "RS", "RW", "TB", "RN", "WS", "SM", "TP", "SA", "SG", "RI", "SE", "SL", "SN", "NN", "LO", "SI", "BP", "SO", "SF", "SX", "OD", "SP", "PG", "CE", "SH", "SC", "ST", "SB", "VC", "SU", "NS", "SV", "WZ", "SW", "SZ", "SY", "TW", "TI", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TX", "TK", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI"
DOB	string	Optional Date of Birth of the employee. Format: MM/DD/YYYY
Address	object	Primary address of the employee.
Address1	string	Street address or PO Box of the employee. Size Range: 46
Address2	string	Optional Suite or apartment number of the employee. Size Range: 46
City	string	City of the employee. Size Range: 50
ProvinceOrState	string	Province or state name of the employee. Allowed values When the country code is US: Allowed values "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP" When the country code is CA: Allowed values "AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" Note: The size range is set to 50 for all countries except the United States and Canada.
ZipCd	string	ZIP code of the employee. Size Range: 5 – 16
Country	string	2-character country code of the employee. Allowed values "US","AF", "AX", "AL", "AG", "AQ", "AN", "AO", "AV", "AY", "AC", "AR", "AM", "AA", "AT", "AS", "AU", "AJ", "BF", "BA", "FQ", "BG", "BB", "BO", "BE", "BH", "BN", "BD", "BT", "BL", "BK", "BC", "BV", "BR", "IO", "VI", "BX", "BU", "UV", "BM", "BY", "CB", "CM", "CA", "CV", "CJ", "CT", "CD", "CI", "CH", "KT", "IP", "CK", "CO", "CN", "CF", "CG", "CW", "CR", "CS", "IV", "HR", "CU", "UC", "CY", "EZ", "DA", "DX", "DJ", "DO", "DR", "TT", "EC", "EG", "ES", "EK", "ER", "EN", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "FP", "FS", "GB", "GA", "GG", "GM", "GH", "GI", "GR", "GL", "GJ", "GQ", "GT", "GK", "GV", "PU", "GY", "HA", "HM", "VT", "HO", "HK", "HQ", "HU", "IC", "IN", "ID", "IR", "IZ", "EI", "IS", "IT", "JM", "JN", "JA", "DQ", "JE", "JQ", "JO", "KZ", "KE", "KQ", "KR", "KN", "KS", "KV", "KU", "KG", "LA", "LG", "LE", "LT", "LI", "LY", "LS", "LH", "LU", "MC", "MK", "MA", "MI", "MY", "MV", "ML", "MT", "IM", "RM", "MR", "MP", "MX", "MQ", "MD", "MN", "MG", "MJ", "MH", "MO", "MZ", "WA", "NR", "BQ", "NP", "NL", "NC", "NZ", "NU", "NG", "NI", "NE", "NF", "CQ", "NO", "MU", "OC", "PK", "PS", "LQ", "PM", "PP", "PF", "PA", "PE", "RP", "PC", "PL", "PO", "RQ", "QA", "RO", "RS", "RW", "TB", "RN", "WS", "SM", "TP", "SA", "SG", "RI", "SE", "SL", "SN", "NN", "LO", "SI", "BP", "SO", "SF", "SX", "OD", "SP", "PG", "CE", "SH", "SC", "ST", "SB", "VC", "SU", "NS", "SV", "WZ", "SW", "SZ", "SY", "TW", "TI", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TX", "TK", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI"
Email	string	Email address of the employee. Size Range: 100 Note: Required if DistributionType is ONLINE_ACCESS.
Fax	string	Optional Fax number of the employee. Size Range: 10
Phone	string	Optional Phone number of the employee. Size Range: 10
CorrectEmployeeData	object	Enter the corrected Employee Name and SSN value. This Object is required, when the IsEmployeeSSNNameCorrection is true. The object should be "null", when the IsEmployeeSSNNameCorrection is false.
PayeeRef	string	Optional Your unique identifier for the employee. Size Range: 50
TINDetails	object	Employee TIN information.
Format	string	Specifies how the TIN is passed. Allowed values "PLAIN_TIN" — Pass TIN directly. "TOKENIZED_TIN" - Pass tokenized TIN.
TINType	string	Specify the TIN type of the employee. Allowed values "SSN"
TIN	string	TIN value according to the Format selected.
IndividualNm	object	Required when TINType is SSN, ITIN, or ATIN. Provide individual name fields instead of BusinessNm.
FirstNm	string	The first name of the individual. Size Range: 20
MiddleNm	string	Optional The middle name of the individual. Size Range: 20
LastNm	string	The last name of the individual. Size Range: 20
Suffix	string	Optional The suffix of the individual's name. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
Email	string	Email address of the employee. Size Range: 100 Note: Required if the DistributionType is either "ONLINE_ACCESS" or "POSTAL_AND_ONLINE"
PrevReportedW2FormData	object	Employee's previously reported Form W-2C information. Required: Yes
Wages	number	Previously reported Wages, Tips, Other Compensation. Required: Yes Size Range: 0 – 999999999.99 Format: Decimal (up to 2 dp)
FedTaxWH	number	Previously reported Federal Income Tax Withheld. Required: Optional Size Range: 0 – 999999999.99
SocSecWages	number	Previously reported Social Security Wages. Required: Optional Size Range: 0 – 999999999.99
SocSecTaxWH	number	Previously reported Social Security Tax Withheld. Required: Optional Size Range: 0 – 999999999.99
MediWages	number	Previously reported Medicare Wages and Tips. Required: Optional Size Range: 0 – 999999999.99
MediTaxWH	number	Previously reported Medicare Tax Withheld. Required: Optional Size Range: 0 – 999999999.99
SocSecTips	number	Previously reported Social Security Tips. Required: Optional Size Range: 0 – 999999999.99
AllocatedTips	number	Previously reported Allocated Tips. Required: Optional Size Range: 0 – 999999999.99
DependtCareBenefits	number	Previously reported Dependent Care Benefits. Required: Optional Size Range: 0 – 999999999.99
Sec457Plan	number	Previously reported Nonqualified Plans, Section 457 portion. Required: Optional Size Range: 0 – 999999999.99
NonSec457Plan	number	Previously reported Nonqualified Plans, Non-Section 457 portion. Required: Optional Size Range: 0 – 999999999.99
CompCode1	string	Previously reported Compensation Code 1. Required: Optional Size Range: 1–2 Note: Codes TT, TP and TA were introduced for TY 2026 to support OBBBA tip / overtime reporting. Allowed values "A", "B", "C", "D", "E", "F", "G", "H", "J", "K", "L", "M", "N", "P", "Q", "R", "S", "T", "V", "W", "Y", "Z", "AA", "BB", "CC", "DD", "EE", "FF", "GG", "HH", "II", "TA", "TT", "TP"
CompAmt1	number	Previously reported Amount for Code 1. Required: Conditional Size Range: 0 – 999999999.99
CompCode2	string	Previously reported Compensation Code 2. Required: Optional Size Range: 1–2 Allowed values "A", "B", "C", "D", "E", "F", "G", "H", "J", "K", "L", "M", "N", "P", "Q", "R", "S", "T", "V", "W", "Y", "Z", "AA", "BB", "CC", "DD", "EE", "FF", "GG", "HH", "II", "TA", "TT", "TP"
CompAmt2	number	Previously reported Amount for Code 2. Required: Conditional Size Range: 0 – 999999999.99
CompCode3	string	Previously reported Compensation Code 3. Required: Optional Size Range: 1–2 Allowed values "A", "B", "C", "D", "E", "F", "G", "H", "J", "K", "L", "M", "N", "P", "Q", "R", "S", "T", "V", "W", "Y", "Z", "AA", "BB", "CC", "DD", "EE", "FF", "GG", "HH", "II", "TA", "TT", "TP"
CompAmt3	number	Previously reported Amount for Code 3. Required: Conditional Size Range: 0 – 999999999.99
CompCode4	string	Previously reported Compensation Code 4. Required: Optional Size Range: 1–2 Allowed values "A", "B", "C", "D", "E", "F", "G", "H", "J", "K", "L", "M", "N", "P", "Q", "R", "S", "T", "V", "W", "Y", "Z", "AA", "BB", "CC", "DD", "EE", "FF", "GG", "HH", "II", "TA", "TT", "TP"
CompAmt4	number	Previously reported Amount for Code 4. Required: Conditional Size Range: 0 – 999999999.99
IsStatEmp	boolean	Previously reported Statutory Employee indicator. Required: Optional Allowed values true, false
IsRetPlan	boolean	Previously reported Retirement Plan indicator. Required: Optional Allowed values true, false
Is3rdPartySickPay	boolean	Previously reported Third-Party Sick Pay indicator. Required: Optional Allowed values true, false
Other	string	Previously reported Other Free-form text used to report items such as state PFL / PML, union dues, etc. Required: Optional Size Range: 1–100
TTOC1	string	Previously reported Treasury Tipped Occupation Code #1 — identifies the Employee's qualifying tipped occupation. New for TY 2026 — supports OBBBA No-Tax-on-Tips reporting. — supports OBBBA No-Tax-on-Tips reporting. Required: Conditional (TY 2026 only) Size Range: 1–3 Note: Required when Box 12 Code TT (Cash Tips) is reported. Applicable only when TaxYear is 2026. Allowed values "000","101", "102", "103", "104", "105", "106", "107", "108","109","110","201","202", "203", "204", "205","206","207", "208", "209","210", "211", "301", "302", "303", "304", "401", "402", "403", "404", "405", "406", "407", "408", "409", "501", "502", "503", "504", "505", "506", "507", "508", "509", "510", "601", "602", "603","604", "605", "606", "607", "608", "609", "610", "611", "701", "702", "703", "704", "705", "706", "801", "802", "803", "804", "805", "806", "807", "808", "809", "810"
TTOC2	string	Previously reported Treasury Tipped Occupation Code #2 — secondary qualifying tipped occupation, if applicable. New for TY 2026. Required: Optional (TY 2026 only) Size Range: 1–3 Applicable only when TaxYear is 2026. Allowed values "000","101", "102", "103", "104", "105", "106", "107", "108","109","110","201","202", "203", "204", "205","206","207", "208", "209","210", "211", "301", "302", "303", "304", "401", "402", "403", "404", "405", "406", "407", "408", "409", "501", "502", "503", "504", "505", "506", "507", "508", "509", "510", "601", "602", "603","604", "605", "606", "607", "608", "609", "610", "611", "701", "702", "703", "704", "705", "706", "801", "802", "803", "804", "805", "806", "807", "808", "809", "810"
ControlNum	string	Previously reported Control Number assigned by the Employer to uniquely identify the W-2C. Required: Optional Size Range: 1–14
State	object []	Previously reported State filing data — Boxes 15–20. Required: Conditional Note: Required when ReturnManifest.IsState is true.
StateCd	string	Box 15 — Two-letter State Code. Required: Yes (if State present) Size Range: 2
StateIdNum	string	Box 15 — Employer's State ID Number. Required: Conditional Size Range: 1–20
StateWages	number	Box 16 — State Wages, Tips, etc. Required: Conditional Size Range: 0 – 999999999.99
StateTax	number	Box 17 — State Income Tax. Required: Optional Size Range: 0 – 999999999.99
LocalityData	object	Boxes 18–20 — Local income / locality information. Required: Optional
LocalWages	number	Box 18 — Local Wages, Tips, etc. Required: Conditional Size Range: 0 – 999999999.99
LocalTax	number	Box 19 — Local Income Tax. Required: Optional Size Range: 0 – 999999999.99
LocalityNm	string	Box 20 — Locality Name. Required: Conditional Size Range: 1–50
County	string	County name (used in states where county-level reporting is required). Required: Optional Size Range: 1–50
TaxTypeCd	string	Tax Type Code identifying the type of local tax being reported. Required: Optional Size Range: 1–2 Allowed values "C", "D", "E", "F", "H", "I", "K", "N"
SchoolDistrictNum	string	School District Number (required for certain Ohio / Pennsylvania filings). Required: Conditional Size Range: 1–10
CorrectedW2FormData	object	Employee's corrected Form W-2C information Required: Yes
Wages	number	Enter the corrected Wages, Tips, Other Compensation. Required: Yes Size Range: 0 – 999999999.99 Format: Decimal (up to 2 dp)
FedTaxWH	number	Enter the corrected Federal Income Tax Withheld. Required: Optional Size Range: 0 – 999999999.99
SocSecWages	number	Enter the corrected Social Security Wages. Required: Optional Size Range: 0 – 999999999.99
SocSecTaxWH	number	Enter the corrected Social Security Tax Withheld. Required: Optional Size Range: 0 – 999999999.99
MediWages	number	Enter the corrected Medicare Wages and Tips. Required: Optional Size Range: 0 – 999999999.99
MediTaxWH	number	Enter the corrected Medicare Tax Withheld. Required: Optional Size Range: 0 – 999999999.99
SocSecTips	number	Enter the corrected Social Security Tips. Required: Optional Size Range: 0 – 999999999.99
AllocatedTips	number	Enter the corrected Allocated Tips. Required: Optional Size Range: 0 – 999999999.99
DependtCareBenefits	number	Enter the corrected Dependent Care Benefits. Required: Optional Size Range: 0 – 999999999.99
Sec457Plan	number	Enter the corrected Nonqualified Plans, Section 457 portion. Required: Optional Size Range: 0 – 999999999.99
NonSec457Plan	number	Enter the corrected Nonqualified Plans, Non-Section 457 portion. Required: Optional Size Range: 0 – 999999999.99
CompCode1	string	Enter the corrected Compensation Code 1 (e.g., A, B, C, D, DD, TT, TP, TA, …) Required: Optional Size Range: 1–2 Note: Codes TT, TP and TA were introduced for TY 2026 to support OBBBA tip / overtime reporting. Allowed values "A", "B", "C", "D", "E", "F", "G", "H", "J", "K", "L", "M", "N", "P", "Q", "R", "S", "T", "V", "W", "Y", "Z", "AA", "BB", "CC", "DD", "EE", "FF", "GG", "HH", "II", "TA", "TT", "TP"
CompAmt1	number	Enter the corrected Amount for Code 1. Required: Conditional Size Range: 0 – 999999999.99
CompCode2	string	Enter the corrected Compensation Code 2. Required: Optional Size Range: 1–2 Allowed values "A", "B", "C", "D", "E", "F", "G", "H", "J", "K", "L", "M", "N", "P", "Q", "R", "S", "T", "V", "W", "Y", "Z", "AA", "BB", "CC", "DD", "EE", "FF", "GG", "HH", "II", "TA", "TT", "TP"
CompAmt2	number	Enter the corrected Amount for Code 2. Required: Conditional Size Range: 0 – 999999999.99
CompCode3	string	Enter the corrected Compensation Code 3. Required: Optional Size Range: 1–2 Allowed values "A", "B", "C", "D", "E", "F", "G", "H", "J", "K", "L", "M", "N", "P", "Q", "R", "S", "T", "V", "W", "Y", "Z", "AA", "BB", "CC", "DD", "EE", "FF", "GG", "HH", "II", "TA", "TT", "TP"
CompAmt3	number	Enter the corrected Amount for Code 3. Required: Conditional Size Range: 0 – 999999999.99
CompCode4	string	Enter the corrected Compensation Code 4. Required: Optional Size Range: 1–2 Allowed values "A", "B", "C", "D", "E", "F", "G", "H", "J", "K", "L", "M", "N", "P", "Q", "R", "S", "T", "V", "W", "Y", "Z", "AA", "BB", "CC", "DD", "EE", "FF", "GG", "HH", "II", "TA", "TT", "TP"
CompAmt4	number	Enter the corrected Amount for Code 4. Required: Conditional Size Range: 0 – 999999999.99
IsStatEmp	boolean	Enter the corrected Statutory Employee indicator. Required: Optional Allowed values true, false
IsRetPlan	boolean	Enter the corrected Retirement Plan indicator. Required: Optional Allowed values true, false
Is3rdPartySickPay	boolean	Enter the corrected Third-Party Sick Pay indicator. Required: Optional Allowed values true, false
Other	string	Enter the corrected Other Free-form text used to report items such as state PFL / PML, union dues, etc. Required: Optional Size Range: 1–100
TTOC1	string	Enter the corrected Treasury Tipped Occupation Code #1 — identifies the Employee's qualifying tipped occupation. New for TY 2026 — supports OBBBA No-Tax-on-Tips reporting. Required: Conditional (TY 2026 only) Size Range: 1–3 Note: Required when Box 12 Code TT (Cash Tips) is reported. Applicable only when TaxYear is 2026. Allowed values "000","101", "102", "103", "104", "105", "106", "107", "108","109","110","201","202", "203", "204", "205","206","207", "208", "209","210", "211", "301", "302", "303", "304", "401", "402", "403", "404", "405", "406", "407", "408", "409", "501", "502", "503", "504", "505", "506", "507", "508", "509", "510", "601", "602", "603","604", "605", "606", "607", "608", "609", "610", "611", "701", "702", "703", "704", "705", "706", "801", "802", "803", "804", "805", "806", "807", "808", "809", "810"
TTOC2	string	Enter the corrected Treasury Tipped Occupation Code #2 — secondary qualifying tipped occupation, if applicable. New for TY 2026. Required: Optional (TY 2026 only) Size Range: 1–3 Applicable only when TaxYear is 2026. Allowed values "000","101", "102", "103", "104", "105", "106", "107", "108","109","110","201","202", "203", "204", "205","206","207", "208", "209","210", "211", "301", "302", "303", "304", "401", "402", "403", "404", "405", "406", "407", "408", "409", "501", "502", "503", "504", "505", "506", "507", "508", "509", "510", "601", "602", "603","604", "605", "606", "607", "608", "609", "610", "611", "701", "702", "703", "704", "705", "706", "801", "802", "803", "804", "805", "806", "807", "808", "809", "810"
ControlNum	string	Enter the corrected Control Number assigned by the Employer to uniquely identify the W-2C. Required: Optional Size Range: 1–14
State	object []	Enter the corrected State filing data — Boxes 15–20. Required: Conditional Note: Required when ReturnManifest.IsState is true.
StateCd	string	Box 15 — Two-letter State Code. Required: Yes (if State present) Size Range: 2
StateCorrectionType	string	Provide the type of correction you are filing. Allowed values VOID - The state filing was submitted incorrectly and should not have been processed CORRECTION - Used to correct previously reported amounts or codes NEW - Used to add new state information that was not included in the original filing. Note: To update a previously filed state, you must first indicate the original state as VOID, then add the new state using the NEW correction type. Also note that you can file for a maximum of five states, including those already present in PrevReportedW2FormData.
StateIdNum	string	Box 15 — Employer's State ID Number. Required: Conditional Size Range: 1–20
StateWages	number	Box 16 — State Wages, Tips, etc. Required: Conditional Size Range: 0 – 999999999.99
StateTax	number	Box 17 — State Income Tax. Required: Optional Size Range: 0 – 999999999.99
LocalityData	object	Boxes 18–20 — Local income / locality information. Required: Optional
LocalWages	number	Box 18 — Local Wages, Tips, etc. Required: Conditional Size Range: 0 – 999999999.99
LocalTax	number	Box 19 — Local Income Tax. Required: Optional Size Range: 0 – 999999999.99
LocalityNm	string	Box 20 — Locality Name. Required: Conditional Size Range: 1–50
County	string	County name (used in states where county-level reporting is required). Required: Optional Size Range: 1–50
TaxTypeCd	string	Tax Type Code identifying the type of local tax being reported. Required: Optional Size Range: 1–2 Allowed values "C", "D", "E", "F", "H", "I", "K", "N"
SchoolDistrictNum	string	School District Number (required for certain Ohio / Pennsylvania filings). Required: Conditional Size Range: 1–10

Response Body

Field	Type	Description
BusinessId	Guid	Unique identifier generated by TaxBandits. Store this for use in all subsequent requests.
PayerRef	string	Your unique identifier for the payer, as provided in the request.
DBARef	string	Your unique identifier for the DBA.
DBAId	Guid	Unique identifier generated for the DBA.
ScheduleFiling	object	Returns the date of the schedule filing.
EFileDate	string	Date of the schedule filing to know when the return to be filed to the IRS.
Info	string	Information about Schedule Filing service.
Form1099Type	string	Denotes the type of form.
Form1099Records	object	Pulls Form W2 records with Success and Error statuses.
SuccessRecords	object[]	It will show the detailed information about the success status of Form W2 Records.
SequenceId	string	A unique reference ID for the submission that can be used to identify a particular record.
RecordId	Guid	An unique identifier generated by TaxBandits when a W2 return is created.
RecipientId	Guid	A unique reference ID for the submission that can be used to identify a particular record.
PayeeRef	string	Your unique identifier for the recipient, as provided in the request.
AccountNum	string	Account number of Payer having multiple accounts for a recipient for whom more than one Form W2 is filed.
Federal	object	Returns the record status and StatusTs of the federal return.
Status	string	Status of the operation.
StatusCd	string	Status code of the operation.
StatusTs	string	Date and time of the return created.
Info	string	Returns information about the Federal Filing service.
State	object[]	Returns a collection of state return information.
StateCd	string	Returns the state code of the state for which the return is filed.
Status	string	Returns the record status of the state return.
StatusCd	string	Date and time of the postal creation.
StatusTs	string	Date and time of the return created.
Info	string	Returns the information about the return processed for the state.
Distribution	object	Returns information about the distribution.
DistributionType	string	Returns the distribution method used.
Postal	object	Returns information about postal mailing.
PostalType	string	Returns the postal service used.
Status	string	Returns the Postal status.
StatusCd	string	Detailed status code.
StatusTs	string	Date and time of the postal created.
Info	string	Returns the information about the postal order.
OnlineAccess	object	Returns the Email address for whom the online access to be given and Status of online access.
Status	string	Returns status of online access for Form W2 return.
Email	string	Email address for whom the online access to be given.
Info	string	Information about the online access service.
ErrorRecords	object[]	It will show the detailed information about the error status of Form W2 Records.
SequenceId	string	A unique reference ID for the submission that can be used to identify a particular DBA. The Sequence ID will be returned in the Response for your reference.
RecordId	Guid	Unique identifier of a record.
Errors	object[]	Validation error details.
Id	string	Validation error code.
Name	string	Name of the validation rule that failed.
Message	string	Clear description of what went wrong and how to fix it.
Errors	object[]	Top-level request errors if the entire request cannot be processed.
Id	string	Validation error code.
Name	string	Name of the validation rule that failed.
Message	string	Clear description of what went wrong and how to fix it.

Payload

Request JSON

Sample	Description	Action
Sample 1	Update W-2C Correction Using Previous Reported Employee Data and Previous Reported W-2 Form Data
Sample 2	W-2C Correction – Federal and State Correction as VOID
Sample 3	W-2C Correction – Federal Correction as EmployeeSSNNameCorrection only
Sample 4	W-2C Correction – Federal Employee Amount with State Correction as NEW and CORRECTION

Sample 1

{
  "SubmissionManifest": {
    "SubmissionId": "a82b774c-aea6-4a43-8bd2-8dd83ddb4c18",
    "TaxYear": "2026"
  },
  "ReturnHeader": {
    "Business": {
      "BusinessId": "f636dced-7054-4a2a-8208-1451e7f764a3"
    }
  },
  "ReturnData": [
    {
      "SequenceId": "1",
      "RecordId": "49c8c122-50dd-4aa8-9a73-dd1c167464e1",
      "ReturnManifest": {
        "IsFederal": true,
        "IsState": true,
        "IsDistribution": true,
        "DistributionDetails": {
          "DistributionType": "POSTAL_AND_ONLINE",
          "PostalType": "USPS_FIRST_CLASS"
        },
        "CorrectionDetails": {
          "IsEmployeeSSNNameCorrection": true
        }
      },
      "PrevReportedEmployeeData": {
        "EmployeeId": null,
        "EmployeeRef": "Payeeref123",
        "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "SSN",
          "TIN": "021-44-2378"
        },
        "IndividualNm": {
          "FirstNm": "David",
          "MiddleNm": "R",
          "LastNm": "Thompson",
          "Suffix": null
        },
        "BusinessNm": null,
        "DBADetails": null,
        "Address": {
          "Address1": "780 Market Street",
          "Address2": "Suite 1200",
          "City": "San Francisco",
          "ProvinceOrState": "CA",
          "ZipCd": "94103",
          "Country": "US"
        },
        "Email": "david.thompson1@sample.com",
        "Fax": "2145550198",
        "Phone": "2145550110"
      },
      "CorrectEmployeeData": {
        "TINDetails": {
          "EmployeeRef": "Payeeref12345",
          "Format": "PLAIN_TIN",
          "TINType": "SSN",
          "TIN": "021-44-5338"
        },
        "IndividualNm": {
          "FirstNm": "David",
          "MiddleNm": "R",
          "LastNm": "Thompson",
          "Suffix": null
        },
        "Email": "david.thompson1@sample.com"
      },
      "PrevReportedW2FormData": {
        "Wages": 176000,
        "FedTaxWH": 36821,
        "SocSecWages": 175000,
        "SocSecTaxWH": 10340,
        "MediWages": 184502,
        "MediTaxWH": 0,
        "SocSecTips": 501,
        "AllocatedTips": 46.91,
        "DependtCareBenefits": 79,
        "Sec457Plan": 100,
        "NonSec457Plan": 0,
        "CompCode1": "TT",
        "CompAmt1": 100,
        "CompCode2": "TT",
        "CompAmt2": 100,
        "CompCode3": "TT",
        "CompAmt3": 100,
        "CompCode4": "TT",
        "CompAmt4": 100,
        "IsStatEmp": true,
        "IsRetPlan": true,
        "Is3rdPartySickPay": true,
        "Other": "MA PFL 316.96, MA PML 493.10",
        "TTOC1": "407",
        "TTOC2": "409",
        "ControlNum": "35231",
        "States": [
          {
            "StateCd": "VA",
            "StateIdNum": "9999999999",
            "StateWages": 180.64,
            "StateTax": 0,
            "LocalityData": [
              {
                "LocalWages": 220.23,
                "LocalTax": 10.45,
                "LocalityNm": "Prisine",
                "County": "adams",
                "TaxTypeCd": "D ",
                "SchoolDistrictNum": null
              }
            ]
          },
          {
            "StateCd": "IN",
            "StateIdNum": "9999999999 999",
            "StateWages": 180.64,
            "StateTax": 0,
            "LocalityData": [
              {
                "LocalWages": 220.23,
                "LocalTax": 10.45,
                "LocalityNm": "Prisine",
                "County": "adams",
                "TaxTypeCd": "D ",
                "SchoolDistrictNum": null
              }
            ]
          }
        ]
      },
      "CorrectedW2FormData": {
        "Wages": 176000,
        "FedTaxWH": 36825,
        "SocSecWages": 175000,
        "SocSecTaxWH": 10340,
        "MediWages": 184502,
        "MediTaxWH": 0,
        "SocSecTips": 501,
        "AllocatedTips": 46.91,
        "DependtCareBenefits": 79,
        "Sec457Plan": 100,
        "NonSec457Plan": 0,
        "CompCode1": "A",
        "CompAmt1": 100,
        "CompCode2": "TP",
        "CompAmt2": 100,
        "CompCode3": "TP",
        "CompAmt3": 100,
        "CompCode4": "TP",
        "CompAmt4": 100,
        "IsStatEmp": true,
        "IsRetPlan": true,
        "Is3rdPartySickPay": true,
        "Other": "MA PFL 316.96, MA PML 493.10",
        "TTOC1": "407",
        "TTOC2": "409",
        "ControlNum": "35231",
        "States": [
          {
            "StateCd": "VA",
            "StateIdNum": "9999999999",
            "StateWages": 80.64,
            "StateCorrectionType": "Correction",
            "StateTax": 0,
            "LocalityData": [
              {
                "LocalWages": 220.23,
                "LocalTax": 10.45,
                "LocalityNm": "Prisine",
                "County": "adams",
                "TaxTypeCd": "D ",
                "SchoolDistrictNum": null
              }
            ]
          },
          {
            "StateCd": "IN",
            "StateIdNum": "9999999999 999",
            "StateWages": 340.64,
            "StateCorrectionType": "Correction",
            "StateTax": 6.9,
            "LocalityData": [
              {
                "LocalWages": 220.23,
                "LocalTax": 10.45,
                "LocalityNm": "Prisine",
                "County": "adams",
                "TaxTypeCd": "D ",
                "SchoolDistrictNum": null
              }
            ]
          }
        ]
      }
    }
  ]
}

Response JSON

Response	Description	Action
200	Success Response - You'll get the below response when the request is processed successfully.
207	Partial Success Response - You'll get the below response when one or more records are created successfully and one or more records fail validation.
400	Bad Request Response - You'll get the below response when the request cannot be processed because of validation errors.
401	Unauthorized Response - You'll get the below response when the access token is missing, expired, or invalid.

Response: 200

{
  "SubmissionId": "621e2120-b511-4c11-9b22-0a1d71263f55",
  "BusinessId": "f636dced-7054-4a2a-8208-1451e7f764a3",
  "PayerRef": "HZN-10001",
  "DBARef": null,
  "DBAId": null,
  "FormW2CRecords": {
    "SuccessRecords": [
      {
        "SequenceId": "1",
        "PrevReportedRecordId": null,
        "RecordId": "2c5e2551-a661-466b-ac88-a028f78f615a",
        "EmployeeId": "c9687573-c4f4-46a2-89f1-fac155c3dc42",
        "EmployeeRef": null,
        "Federal": {
          "Status": "CREATED",
          "StatusCd": "FED_001",
          "StatusTs": "2026-09-15 10:01:34 -04:00",
          "Info": "Return created successfully",
          "Errors": []
        },
        "State": [
          {
            "StateCd": "VA",
            "Status": "CREATED",
            "StatusCd": "STATE_001",
            "StatusTs": "2026-09-15 10:01:34 -04:00",
            "Info": "State filing will be sent directly to the state department",
            "Errors": []
          }
        ],
        "Distribution": {
          "DistributionType": "POSTAL_AND_ONLINE",
          "Postal": {
            "PostalType": "USPS_FIRST_CLASS",
            "Status": "CREATED",
            "StatusCd": "POSTAL_001",
            "StatusTs": "2026-09-15 10:01:34 -04:00",
            "Info": "Postal order created"
          },
          "OnlineAccess": {
            "Status": "CREATED",
            "StatusCd": "ONLINE_001",
            "Email": "david.thompson1@sample.com",
            "Info": "Online access order initiated successfully"
          }
        }
      }
    ],
    "ErrorRecords": null
  },
  "Errors": null
}

W-9/W-8 Automation

1099 Automation

TIN Matching

W-2 Automation

941/940 Automation

1098-T Automation

ACA Automation

Extension Automation

1042-S Automation

Supported Forms

Gig Software

Payroll Software

Affiliate Software

HOA Software

Reselling Platform

HCM Providers

Property Management

Healthcare Market Research Platforms

Update

Update

Request Body

Response Body

Sample 1

Response: 200