Skip to main content
Version: 2.0.0

Create

Create

Use this endpoint to generate a new withholding filing for the state of Utah.

Employers must file the quarterly withholding return (TC-941E) for each quarter, including the fourth quarter, which also serves as the reconciliation return. The return must be filed for each quarter even if no taxes were withheld.

POST StateFilings/UTTC941EWH/Create 

Request Body

FieldTypeDescription
StateWHRecordsObject[]Object to identify the records.
SequenceIdStringA unique identifier for this record. Size Range: ..50
ReturnHeaderObjectContains business information.
TaxYearStringThe tax year for which the Form TC-941E is to be filed.
Allowed values

2025,2026

QtrStringThe quarter for which the Form TC-941E is to be filed.
Allowed values

"Q1", "Q2", "Q3", "Q4"

BusinessobjectObject to identify the Business Details.
BusinessIdGuidOptional 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.
PayerRefstringOptional Your unique identifier for the payer. Can replace BusinessId in future requests. Size Range: 50
IsDefaultBusinessBooleanWhen set to TRUE, this business will be set as the default across requests that do not specify a business.
TINDetailsobjectTIN information for the business.
FormatstringSpecifies how the TIN is passed.
Allowed values

"PLAIN_TIN" — Pass TIN directly. "TOKENIZED_TIN" — Pass tokenized TIN.

TINTypestringSpecify the TIN type of the business.
Allowed values

"EIN", "SSN", "QI-EIN", "ITIN", "WP-EIN", "WT-EIN", "NQI-EIN", "IRSN"

TINstringThe TIN value according to the Format selected.
IndividualNmobjectRequired when TINType is SSN. Provide individual name fields instead of BusinessNm.
FirstNmstringThe first name of the individual. Size Range: 20
MiddleNmstringOptional Middle name of the individual. Size Range: 20
LastNmstringThe last name of the individual. Size Range: 20
SuffixstringOptional Suffix of the individual's name.
Allowed values

"Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"

BusinessNmstringLegal name of the business. Required when TINType is EIN. Size Range: 75
NameCtrlstringName control of the business as registered with the IRS. Size Range: 3..4
DBADetailsobject[]Optional DBA (Doing Business As) information.
DBANmstringName of the DBA. Size Range: 75
DBARefstringUnique identifier for the DBA. Size Range: 1-50
DBAIdGuidTaxBandits-generated DBA identifier.
Addressobject[]Address information of the DBA.
Address1stringStreet address or PO Box. Size Range: 46
Address2stringOptional Suite or apartment number. Size Range: 46
CitystringDBA's city. Size Range: 50
ProvinceOrStatestringDBA's province or state name.
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.
ZipcdstringDBA's ZIP code. Size Range: 5-16
CountrystringDBA'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"

EmailstringOptional Email address of the Business. Size Range: ..100
AddressobjectPrimary address of the business.
Address1stringStreet address or PO Box of the business. Size Range: 46
Address2stringOptional Suite or apartment number of the business. Size Range: 46
CitystringCity of the business. Size Range: 50
ProvinceOrStatestringProvince or state name of the business.
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.
ZipCdstringZIP code of the business. Size Range: 5-16
Countrystring2-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"

ContactDetailsobject[]Details of the person the IRS can contact regarding the given business.
FirstNmstringFirst name of the contact person. Size Range: 20
MiddleNmstringOptional Middle name of the contact person. Size Range: 20
LastNmstringLast name of the contact person. Size Range: 20
SuffixstringOptional The suffix of the contact person.
Allowed values

"Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"

PhonestringOptional Phone number of the contact person. Size Range: 10 digits
PhoneExtnstringOptional Phone extension number. Size Range: 5
EmailstringOptional Email address of the contact person. Size Range: ..100
FaxstringOptional Fax number of the contact person. Size Range: 10 digits
BusinessTypeStringLegal structure of the business.
Allowed values

"ESTE", "PART", "CORP", "EORG", "SPRO", "SLGOV"

SigningAuthorityObjectDetails of the person authorized to sign the return.
FirstNmStringFirst name of the signatory. Size Range: 20
MiddleNmStringOptional Middle name of the signatory. Size Range: 20
LastNmStringLast name of the signatory. Size Range: 20
SuffixStringOptional The suffix of the signatory.
Allowed values

"Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"

PhoneStringOptional Phone number of the signatory. Size Range: 10 digits
PhoneExtnStringOptional Phone extension number of the signatory. Size Range: 5
BusinessMemberTypeStringOptional Title or role of the signatory.
Allowed values

"CORPORATESECRETARY", "SECRETARYTREASURER", "PARTNER", "GENERALPARTNER", "LIMITEDPARTNER", "LLCMEMBER", "MANAGINGMEMBER", "MANAGER", "TAXMATTERPARTNER", "PRESIDENT", "VICEPRESIDENT", "CORPORATETREASURER", "TREASURER", "ASSISTANTTREASURER", "CHIEFACCOUNTINGOFFICER", "CHIEFEXECUTIVEOFFICER", "CHIEFFINANCIALOFFICER", "TAXOFFICER", "CHIEFOPERATINGOFFICER", "CORPORATEOFFICER", "EXECUTIVEDIRECTOR", "DIRECTOR", "CHAIRMAN", "EXECUTIVEADMINISTRATOR", "RECEIVER", "PASTOR", "ASSISTANTTORELIGIOUSLEADER", "REVEREND", "PRIEST", "MINISTER", "RABBI", "LEADEROFRELIGIOUSORGANIZATION", "SECRETARY", "DIRECTOROFTAXATION", "DIRECTOROFPERSONNEL", "ADMINISTRATOR", "EXECUTOR", "TRUSTEE", "FIDUCIARY", "OWNER", "SOLEPROPRIETOR", "MEMBER", "SOLEMEMBER", "REPORTINGAGENT"

ReturnDataObjectContains the return information.
FormTC941EObjectIdentifies the Form TC-941E data.
WHIdNumberstringUtah Withholding Account number. Size Range: 14 characters (11 digits followed by 'WTH')
Allowed Format: XXXXXXXX-XXX-WTH
TotalGrossWagesstringTotal gross wages reported for the quarter. Size Range: 0-999999999999.99
FedralTaxWithheldstringEnter backup withholding. Size Range: 0-999999999999.99
UTTaxWithheldstringUtah tax withheld for the quarter. Size Range: 0-999999999999.99
TotalTaxWithheldstringTotal Utah income tax withheld for the year. Size Range: 0-999999999999.99
TotalNumberOfW2stringTotal number of Utah W-2s with Utah wages or withholding issued for the year. Size Range: 0-99999999999999
TotalNumberOf1099stringTotal number of Utah 1099s with Utah withholding you issued for the year. Size Range: 0-99999999999999

Response Body

FieldTypeDescription
SubmissionIdGuidUnique identifier of a submission.
SuccessRecordsobject[]It will show the detailed information about the success status of Form TC-941E Records.
SequenceIdstringA unique number given by an inbound application to identify particular records.
BusinessIdGuidUnique identifier of a Business.
PayerRefstringUnique identifier of the payer.
RecordIdGuidAn unique identifier generated by TaxBandits when a TC-941E return is created.
FormTypestringDenotes the type of withholding form (Form TC-941E).
StatusstringReturns the record status of return.
StatusTsstringDate and time of the return created.
InfostringReturns the information about the return.
Errorsobject[]Displays error information related to the state returns of Form TC-941E.
IdstringReturns the validation error ID.
NamestringName of the validation error.
ErrorRecordsobject[]Provides detailed information about the error status of Form TC-941E records.
SequenceIdstringA 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.
RecordIdGuidUnique identifier for the record.
Errorsobject[]Displays detailed error information.
IdstringReturns the validation error ID.
NamestringName of the validation error.
MessagestringDescription of the validation error.

Request JSON​

Create a UTAH Withholding Form for Q4

{
"StateWHRecords": [
{
"SequenceId": "001",
"ReturnHeader": {
"TaxYear": "2025",
"Qtr": "Q4",
"Business": {
"BusinessNm": "Vertex Construction LLC",
"TINDetails": {
"Format": "PLAIN_TIN",
"TINType": "EIN",
"TIN": "45-9875464"
},
"DBADetails": {
"DBANm": "Vertex Builders",
"DBARef": "DBA1001",
"Address": {
"Address1": "50 West Broadway",
"Address2": "Suite 300",
"City": "Salt Lake City",
"ProvinceOrState": "UT",
"ZipCd": "84101",
"Country": "US"
}
},
"Address": {
"Address1": "275 East 400 South",
"Address2": "Suite 200",
"City": "Salt Lake City",
"ProvinceOrState": "UT",
"ZipCd": "84111",
"Country": "US"
},
"Email": "support@vertexconstruction.com",
"ContactDetails": {
"FirstNm": "Michael",
"LastNm": "Carter",
"Phone": "8015552140",
"Email": "sample@vertexconstruction.com",
"Fax": "8015552141"
},
"BusinessType": "ESTE",
"SigningAuthority": {
"FirstNm": "Michael",
"LastNm": "Carter",
"Phone": "8015552140",
"BusinessMemberType": "ADMINISTRATOR"
}
}
},
"ReturnData": {
"FormTC941E": {
"WHIdNumber": "12345678901WTH",
"TotalGrossWages": "5000.00",
"FedralTaxWithheld": "50.00",
"UTTaxWithheld": "400.00",
"TotalTaxWithheld": "450.00",
"TotalNumberOfW2": 10,
"TotalNumberOf1099": 10
}
}
}
]
}

Response JSON​

Success Response - This is a sample response for successful API requests.

{
"SubmissionId": "01a11185-7ab9-7103-847b-9c4a0f656e20",
"SuccessRecords": [
{
"SequenceId": "001",
"BusinessId": "e0385257-f888-4940-bb0f-aa0b45d77da1",
"PayerRef": null,
"RecordId": "01a11185-7c25-72ae-9761-9b5cbd776db4",
"FormType": "TC941E",
"Status": "CREATED",
"StatusTs": "2026-10-06 10:02:03 -04:00",
"Info": null,
"Errors": null
}
],
"ErrorRecords": null,
"Errors": null
}