Skip to main content
Version: 1.7.3

Update

Update

Use this endpoint to update the information on existing TX UI C3 forms that are already created for a specific employer (payer).

Note:

You cannot update a return once it has been transmitted.

PUTStateFilings/TXUI/Update
Run in Postman

Request Body

FieldTypeDescription
SubmissionIdGuidUnique identifier created by TaxBandits for each submission. Not required when you are creating a return.
StateUIRecordsObject[]Object to identify the records.
SequenceIdStringA unique identifier for this record.
Size Range: ..50
ReturnHeaderObjectContains information about the Business details.
TaxYrstringThe tax year for which the Form C-3 is to be filed.
Allowed values

"2025"

QtrstringThe quarter for which the Form C-3 is to be filed.
Allowed values

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

BusinessObjectObject to identify the business details.
BusinessIdGuidOptional Use the unique identifier provided in the response from the Business CREATE endpoint.
BusinessNmstringName of the business.
Size Range: ..75
TradeNmstringOptional Name under which the business operates.
Size Range: ..75
IsEINBooleanWhen true, identifies the business with an EIN.
EINorSSNstringWhen IsEIN is true, use the Employer Identification Number (EIN)
Note: IsEIN should always be set to true, as EIN is the only allowed TIN type for state payroll forms.
Size Range: 9-11
EmailstringOptional Email address of the business.
Size Range: ..100
ContactNmstringOptional Name of the person who can be contacted by the State Agency.
Size Range: ..27
PhonestringOptional Phone number of the business.
Size Range: 10
PhoneExtnstringOptional Extension of the business phone number.
Size Range: ..5
FaxstringOptional Fax number of the business.
Size Range: 10
BusinessTypestringType of business.
Size Range: 4
Allowed values

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

SigningAuthorityobjectDetails of the person who is authorized to sign the return.
NamestringName of the signing authority.
Size Range: ..35
PhonestringPhone number of the signing authority.
Size Range: 10
BusinessMemberTypestringBusiness title of the signing authority
Size Range: 5..29
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"

KindOfEmployerstringOptional Identifies the kind of employer.
Allowed values

"FEDERALGOVT", "STATEORLOCAL501C", "NONGOVT501C", "STATEORLOCALNON501C", "NONEAPPLY"

KindOfPayerstringOptional Identifies the kind of payer.
Allowed values

"REGULAR941", "REGULAR944", "AGRICULTURAL943", "HOUSEHOLD", "MILITARY", "MEDICAREQUALGOVEM", "RAILROADFORMCT1"

IsBusinessTerminatedBooleanWhen true, indicates that the business is terminated.
IsForeignObjectWhen true, indicates that the business has a foreign address.
USAddressobjectIf IsForeign is false, pass the US address of the business.
Address1stringEmployer/Payer's US address (street or post office box of that locality).
Size Range: ..46
Address2stringOptional Employer/Payer's suite or apartment.
Size Range: ..46
CitystringEmployer/Payer's city.
Size Range: ..50
StatestringEmployer/Payer's state code. Refer to static values.
Size Range: 2
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"

ZipCdstringEmployer/Payer's zip code.
Size Range: 5..10
ForeignAddressObjectIf IsForeign is true, pass the foreign address of the business.
Address1stringEmployer/Payer's foreign address (street address or post office box of that locality).
Size Range: ..50
Address2stringOptional Employer/Payer's suite or apartment.
Size Range: ..50
CitystringEmployer/Payer's city.
Size Range: ..50
ProvinceOrStateNmstringEmployer/Payer's province or state name.
Size Range: ..50
CountrystringEmployer/Payer's country.
Size Range: 2
Allowed values

"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"

PostalCdstringEmployer/Payer's postal code.
Size Range: ..16
ReturnDataObjectContains the return information.
FormC3ObjectIdentifies the Form C3 data.
UIIdNumstringEmployer ID number.
Sample format: XXXXXXXXX
Size Range:9
L2CountyCodestringEmployer's county code
Allowed values

"001", "003", "005", "007", "009", "011", "013", "015", "017", "019", "021", "023", "025", "027", "141", "143", "145", "147", "149", "151" "153", "155", "157", "159", "161", "163", "165", "167", "071", "073", "075", "077", "079", "081", "083", "085", "087", "089", "091", "093", "095", "097"

L4TaxRateNumberTax rate for the quarter.
Size Range: 1-100
L5NAICSCodeNumberNorth American Industry Classification System code that best classifies the employer.
Sample format: XXXXXX
IsNoWageReportedBooleanWhen true, indicates that no wages were reported for the quarter.
L10NumOfEmployeesObjectIdentifies the total number of employees for the quarter.
Month1TotEmployeesstringTotal number of employees in month 1 of the quarter.
Size Range: 0-9999999
Month2TotEmployeesstringTotal number of employees in month 2 of the quarter.
Size Range: 0-9999999
Month3TotEmployeesstringTotal number of employees in month 3 of the quarter.
Size Range: 0-9999999
L11CountyCodestringCounty code of the county in which you had the greatest number of employees.
Allowed values

"001", "003", "005", "007", "009", "011", "013", "015", "017", "019", "021", "023", "025", "027", "141", "143", "145", "147", "149", "151" "153", "155", "157", "159", "161", "163", "165", "167", "071", "073", "075", "077", "079", "081", "083", "085", "087", "089", "091", "093", "095", "097"

L12NoOfMultiCntyEmpNumberNumber of employees in more than one county in texas
Size Range: 0-9999999
IsOtherStateWagesBooleanWhen true, it identifies that wages exist from another state.
L13TotGrossWagesNumberTotal gross wages reported for the quarter.
Size Range: ..9999999.99
L14TotTaxableWagesNumberTaxable wages for the quarter.
Size Range: ..9999999.99
L2TotExcessWagesNumberExcess wages for the quarter.
Size Range: ..9999999.99
L15UITaxDueNumberTax due for the quarter.
Size Range: 0-9999999.99
L16InterestNumberOptional Interest for the quarter.
Size Range: 0-9999999.99
L17IPenaltyNumberOptional Penalty for the quarter.
Size Range: 0-9999999.99
L18PrevAdjAmtNumberBalance due from prior periods
Size Range: 0-9999999.99
L19TotDueAmtNumberTotal tax due for the quarter
Size Range: 0-9999999.99
AddEmployeeDetailsObjectObject to add Employee to the C-3 form
EmpSequenceIdstringA unique number to identify this record.
Size Range: ..10
EmployeeIdGuidOptional A unique ID generated by TaxBandits after the return is created and returned in the response.
EmpRefstringA unique identifier of the employee.
SSNstringEmployee's Social Security Number (SSN).
Size Range: 9-11
FirstNmstringEmployee's first name.
Size Range: 15
MiddleNmstringOptional Employee's middle name.
Size Range: 15
LastNmstringEmployee's last name.
Size Range: 20
SuffixstringOptional Employee's suffix.
Allowed values

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

USAddressobjectIf IsForeign is false, pass the US address of the business.
Address1stringEmployer/Payer's US address (street or post office box of that locality).
Size Range: ..46
Address2stringOptional Employer/Payer's suite or apartment.
Size Range: ..46
CitystringEmployer/Payer's city.
Size Range: ..50
StatestringEmployer/Payer's state code. Refer Static values.
Size Range: 2
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"

ZipCdstringEmployer/Payer's zip code.
Size Range: 5..10
GrossWagesNumberGross wages of the employee.
Size Range: 0-9999999.99
TaxableWagesNumberTaxable wages of the employee.
Size Range: 0-9999999.99
ExcessWagesNumberExcess wages of the employee.
Size Range: 0-9999999.99
OutOfStateTaxableWagesNumberOut of state taxable wages of the employee.
Size Range: 0-9999999.99
RemoveEmployeeDetailsObjectObject to remove employee details from the return
EmployeeIdGuidOptional A unique ID generated by TaxBandits after the return is created and returned in the response.
EmpRefstringA unique identifier of the employee.

Response Body

FieldTypeDescription
SubmissionIdGuidUnique identifier for a submission.
SuccessRecordsobject[]Provides detailed information about the success status of Form ES903A 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.
BusinessIdGuidUnique identifier for the business (payer) generated by TaxBandits.
PayerRefstringUnique identifier for the business (payer) provided by you.
RecordIdGuidA unique identifier generated by TaxBandits when a Form ES903A return is created.
FormTypestringType of form.
StatusstringReturns the record status.
StatusTsstringReturns the date and time when the return was created.
InfostringProvides additional information about the return.
Errorsobject[]Displays error information related to the state returns of Form ES903A.
IdstringReturns the validation error ID.
NamestringName of the validation error.
ErrorRecordsobject[]Provides detailed information about the error status of Form ES903A 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​

{
  "StateUIRecords": [
    {
      "SequenceId": "001",
      "ReturnHeader": {
        "TaxYr": "2025",
        "Qtr": "Q4",
        "Business": {
          "BusinessId": null,
          "BusinessNm": "Snowdaze LLC",
          "TradeNm": "Mayfill Tech",
          "IsEIN": true,
          "EINorSSN": "74-8756945",
          "Email": "james@sample.com",
          "ContactNm": "John",
          "Phone": "7894561231",
          "IsForeign": false,
          "BusinessType": "ESTE",
          "SigningAuthority": {
            "Name": "James Smith",
            "Phone": "9934567890",
            "BusinessMemberType": "ADMINISTRATOR"
          },
          "USAddress": {
            "Address1": "12 Main St",
            "Address2": "CC avenue",
            "City": "Rock Hill",
            "State": "SC",
            "ZipCd": "29730"
          },
          "ForeignAddress": {
            "Address1": null,
            "Address2": null,
            "City": null,
            "ProvinceOrStateNm": null,
            "Country": null,
            "PostalCd": null
          }
        }
      },
      "ReturnData": {
        "FormC3": {
          "UIIdNum": "123456789",
          "L2CountyCode": "113",
          "L4TaxRate": 10,
          "L5NAICSCode": "123431",
          "IsNoWageReported": false,
          "L10NumOfEmployees": {
            "Month1TotEmployees": 50,
            "Month2TotEmployees": 124,
            "Month3TotEmployees": 46
          },
          "L11CountyCode": "113",
          "L12NoOfMultiCntyEmp": 220,
          "IsOtherStateWages": false,
          "L13TotGrossWages": 5000,
          "L14TotTaxableWages": 4000,
          "L15UITaxDue": 0,
          "L16Interest": 1000,
          "L17Penalty": 300,
          "L18PrevAdjAmt": 300,
          "L19TotDueAmt": 300,
          "AddEmployeeDetails": [
            {
              "EmpSequenceId": "11",
              "EmpRef": "Payee01",
              "EmployeeId": null,
              "SSN": "761456924",
              "FirstNm": "John",
              "MiddleNm": "Joe",
              "LastNm": "Smith",
              "Suffix": null,
              "USAddress": {
                "Address1": "12 Main St",
                "Address2": "CC avenue",
                "City": "Rock Hill",
                "State": "SC",
                "ZipCd": "29730"
              },
              "GrossWages": 1000,
              "TaxableWages": 1000,
              "ExcessWages": 0,
              "OutOfStateTaxableWages": 0
            }
          ],
           "RemoveEmployeeDetails": [
            {
              "EmployeeId": null,
              "EmployeeRef": "Emp001"
            },
            {
              "EmployeeId": null,
              "EmployeeRef": "Emp002"
            }
          ]

        }
      }
    }
  ]
}

Response JSON​

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

{
"StatusCode": "200",
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "0199c873-73a6-777d-a932-0453fa4b9b13",
"SuccessRecords": [
  {
    "SequenceId": "001",
    "BusinessId": "fd1ab53b-7175-4230-8fa3-80c73e72fecf",
    "PayerRef": null,
    "RecordId": "0199c873-7683-74c9-9cb6-b72655998a89",
    "EmployeeData": [
      {
        "EmployeeId": "4e288a51-e54b-464d-afc8-23790a8beb5a",
        "EmpRef": "8290"
      },
      {
        "EmployeeId": "3cf1a21d-d0ce-438f-bdbb-e3c3bd129eb7",
        "EmpRef": "82928"
      }
    ],
    "FormType": "UCE101",
    "Status": "UPDATED",
    "StatusTs": "2025-10-09 06:10:34 -04:00",
    "Info": null,
    "Errors": null
  }
],
"ErrorRecords": null,
"Errors": null
}