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
| Field | Type | Description |
|---|---|---|
| StateWHRecords | Object[] | Object to identify the records. |
| SequenceId | String | A unique identifier for this record. Size Range: ..50 |
| ReturnHeader | Object | Contains business information. |
| TaxYear | String | The tax year for which the Form TC-941E is to be filed. Allowed values2025,2026 |
| Qtr | String | The quarter for which the Form TC-941E is to be filed. Allowed values"Q1", "Q2", "Q3", "Q4" |
| 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", "SSN", "QI-EIN", "ITIN", "WP-EIN", "WT-EIN", "NQI-EIN", "IRSN" |
| 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. 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" Allowed values"AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" |
| 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" |
| string | Optional Email address of the Business. Size Range: ..100 | |
| 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. 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" Allowed values"AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" |
| 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 |
| string | Optional Email address of the contact person. Size Range: ..100 | |
| Fax | string | Optional Fax number of the contact person. Size Range: 10 digits |
| BusinessType | String | Legal structure of the business.Allowed values"ESTE", "PART", "CORP", "EORG", "SPRO", "SLGOV" |
| SigningAuthority | Object | Details of the person authorized to sign the return. |
| FirstNm | String | First name of the signatory. Size Range: 20 |
| MiddleNm | String | Optional Middle name of the signatory. Size Range: 20 |
| LastNm | String | Last name of the signatory. Size Range: 20 |
| Suffix | String | Optional The suffix of the signatory. Allowed values"Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII" |
| Phone | String | Optional Phone number of the signatory. Size Range: 10 digits |
| PhoneExtn | String | Optional Phone extension number of the signatory. Size Range: 5 |
| BusinessMemberType | String | Optional 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" |
| ReturnData | Object | Contains the return information. |
| FormTC941E | Object | Identifies the Form TC-941E data. |
| WHIdNumber | string | Utah Withholding Account number. Size Range: 14 characters (11 digits followed by 'WTH') Allowed Format: XXXXXXXX-XXX-WTH |
| TotalGrossWages | string | Total gross wages reported for the quarter. Size Range: 0-999999999999.99 |
| FedralTaxWithheld | string | Enter backup withholding. Size Range: 0-999999999999.99 |
| UTTaxWithheld | string | Utah tax withheld for the quarter. Size Range: 0-999999999999.99 |
| TotalTaxWithheld | string | Total Utah income tax withheld for the year. Size Range: 0-999999999999.99 |
| TotalNumberOfW2 | string | Total number of Utah W-2s with Utah wages or withholding issued for the year. Size Range: 0-99999999999999 |
| TotalNumberOf1099 | string | Total number of Utah 1099s with Utah withholding you issued for the year. Size Range: 0-99999999999999 |
Response Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier of a submission. |
| SuccessRecords | object[] | It will show the detailed information about the success status of Form TC-941E Records. |
| SequenceId | string | A unique number given by an inbound application to identify particular records. |
| BusinessId | Guid | Unique identifier of a Business. |
| PayerRef | string | Unique identifier of the payer. |
| RecordId | Guid | An unique identifier generated by TaxBandits when a TC-941E return is created. |
| FormType | string | Denotes the type of withholding form (Form TC-941E). |
| Status | string | Returns the record status of return. |
| StatusTs | string | Date and time of the return created. |
| Info | string | Returns the information about the return. |
| Errors | object[] | Displays error information related to the state returns of Form TC-941E. |
| Id | string | Returns the validation error ID. |
| Name | string | Name of the validation error. |
| ErrorRecords | object[] | Provides detailed information about the error status of Form TC-941E records. |
| 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. |
| RecordId | Guid | Unique identifier for the record. |
| Errors | object[] | Displays detailed error information. |
| Id | string | Returns the validation error ID. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
Request JSON
- Sample 1
- Sample 2
- Sample 3
- Sample 4
- Sample 5
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
}
}
}
]
}
Create a UTAH Withholding Form for other Quarter
{
"StateWHRecords": [
{
"SequenceId": "001",
"ReturnHeader": {
"TaxYear": "2025",
"Qtr": "Q2",
"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": null,
"TotalNumberOfW2": null,
"TotalNumberOf1099": null
}
}
}
]
}
Create a Utah Witholding form with BusinessId
{
"StateWHRecords": [
{
"SequenceId": "001",
"ReturnHeader": {
"TaxYear": "2025",
"Qtr": "Q2",
"Business": {
"BusinessId": "fd8da62c-07c7-4d26-b049-c7be6af651f5"
}
},
"ReturnData": {
"FormTC941E": {
"WHIdNumber": "12345678901WTH",
"TotalGrossWages": "5000.00",
"FedralTaxWithheld": "50.00",
"UTTaxWithheld": "400.00",
"TotalTaxWithheld": null,
"TotalNumberOfW2": null,
"TotalNumberOf1099": null
}
}
}
]
}
Create a Utah Witholding form with Foreign Address
{
"StateWHRecords": [
{
"SequenceId": "001",
"ReturnHeader": {
"TaxYear": "2025",
"Qtr": "Q2",
"Business": {
"BusinessNm": "Vertex Construction LLC",
"TINDetails": {
"Format": "PLAIN_TIN",
"TINType": "EIN",
"TIN": "45-2875464"
},
"DBADetails": {
"DBANm": "Vertex Builders",
"DBARef": "DBA1001",
"Address": {
"Address1": "100 King Street West",
"Address2": "Suite 1600",
"City": "Toronto",
"ProvinceOrState": "ON",
"ZipCd": "M5X 1A9",
"Country": "CA"
}
},
"Address": {
"Address1": "10 Downing Street",
"Address2": null,
"City": "London",
"ProvinceOrState": "ENG",
"ZipCd": "SW1A 2AA",
"Country": "UK"
},
"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": null,
"TotalNumberOfW2": null,
"TotalNumberOf1099": null
}
}
}
]
}
Create a multiple Utah Witholding form for all Quater
{
"StateWHRecords": [
{
"SequenceId": "001",
"ReturnHeader": {
"TaxYear": "2025",
"Qtr": "Q1",
"Business": {
"BusinessNm": "Vertex Construction LLC",
"TINDetails": {
"Format": "PLAIN_TIN",
"TINType": "EIN",
"TIN": "45-2874464"
},
"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": null,
"TotalNumberOfW2": null,
"TotalNumberOf1099": null
}
}
},
{
"SequenceId": "002",
"ReturnHeader": {
"TaxYear": "2025",
"Qtr": "Q2",
"Business": {
"BusinessNm": "Vertex Construction LLC",
"TINDetails": {
"Format": "PLAIN_TIN",
"TINType": "EIN",
"TIN": "45-2874464"
},
"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": null,
"TotalNumberOfW2": null,
"TotalNumberOf1099": null
}
}
},
{
"SequenceId": "003",
"ReturnHeader": {
"TaxYear": "2025",
"Qtr": "Q3",
"Business": {
"BusinessNm": "Vertex Construction LLC",
"TINDetails": {
"Format": "PLAIN_TIN",
"TINType": "EIN",
"TIN": "45-2874464"
},
"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": null,
"TotalNumberOfW2": null,
"TotalNumberOf1099": null
}
}
},
{
"SequenceId": "004",
"ReturnHeader": {
"TaxYear": "2025",
"Qtr": "Q4",
"Business": {
"BusinessNm": "Vertex Construction LLC",
"TINDetails": {
"Format": "PLAIN_TIN",
"TINType": "EIN",
"TIN": "45-2874464"
},
"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
- 200
- 207
- 400
- 401
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
}
{
"SubmissionId": "01a1117f-b422-75d8-825e-50c4305d1de4",
"SuccessRecords": [
{
"SequenceId": "001",
"BusinessId": "3b578e73-a206-4146-8fb5-19dca6487c16",
"PayerRef": null,
"RecordId": "01a1117f-b5c0-74c9-8d36-80b0d8f2eec1",
"FormType": "TC941E",
"Status": "CREATED",
"StatusTs": "2026-10-06 09:55:44 -04:00",
"Info": null,
"Errors": null
}
],
"ErrorRecords": [
{
"SequenceId": "002",
"RecordId": null,
"Errors": [
{
"Id": "S00-003290",
"Name": "ReturnHeader.Business.TINDetails.TIN",
"Message": "TIN is required."
}
]
}
],
"Errors": [
{
"Id": "S00-000184",
"Name": "Error Records",
"Message": "Some of the records are errored. Please read the Error Records for more details."
}
]
}
Bad Request Response - You'll get the below response when your API requests contain any validation errors.
{
"SubmissionId": null,
"SuccessRecords": null,
"ErrorRecords": [
{
"SequenceId": "001",
"RecordId": null,
"Errors": [
{
"Id": "S00-000664",
"Name": "Business[0].SigningAuthority.BusinessMemberType",
"Message": "BusinessMemberType is required"
}
]
}
],
"Errors": null
}
Unauthorized Response - You'll get the below response when your API requests don't contain valid authentication credentials.
{
"Errors": [
{
"Id": "AUTH-100018",
"Name": "Authorization",
"Message": "JWT EXPIRED"
}
]
}