Skip to main content
Version: 1.7.3

Update

Update

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

Note:

You cannot update a return once it has been transmitted.

PUTStateFilings/COUI/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 business information.
TaxYrstringThe tax year for which the Form UITR1 is to be filed.
Allowed values

"2025", "2026"

QtrstringThe quarter for which the Form UITR1 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.
FormUITR1ObjectIdentifies the Form UITR1 data.
UIIdNumStringEmployer's Colorado Unemployment Account Number
Size Range: 8 digits
Sample format: 99999999
IsNoWageReportedBooleanWhen true, indicates that no wage is reported in this quarter
TaxRateNumberTax rate for the quarter.
Size Range: 1-100
TotWagesAmtNumberTotal wages paid for the quarter.
Size Range: 0-99999999999.99
TotExcessWageAmtNumberTotal excess wages paid for the quarter.
Size Range: 0-99999999999.99
TotTaxableWagesNumberTotal taxable wages paid for all employees in the quarter that is subject to Colorado Unemployment Insurance.
Size Range: 0-99999999999.99
TaxDueNumberTotal tax due for the quarter
Size Range: 0-99999999999.99
InterestNumberInterest for the quarter (1% per month after the due date).
Size Range: 0-99999999999.99
LateRepPenaltyNumberOptional late reporting penalty
Note: Each late report is assessed a $50 penalty. Each additional quarter that a report is late results in an assessment of $50. The penalty for newly subject employers is $10 for each occurrence during the first four quarters of coverage.
BalanceDueNumberTotal remittance due for the quarter.
Size Range: 0-99999999999.99
NumOfEmployeesObjectIdentifies 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
AddEmployeeDetailsObjectObject to add Employee to the CO UITR1 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.
UnitNumStringAn identification number to identify wages by worksite
Size range: 1-999
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"

IsMonth1BooleanWhen true, indicates the employee was employed during the month 1 of the quarter.
IsMonth2BooleanWhen true, indicates the employee was employed during the month 2 of the quarter.
IsMonth3BooleanWhen true, indicates the employee was employed during the month 3 of the quarter.
IsSeasonalBooleanWhen true, indicates the employee’s employment type is seasonal
GrossWagesAmtNumberTotal gross wages reported for the quarter.
Size Range: ..99999999999.99
TaxableWagesNumberTotal taxable wages for the quarter
Size Range: ..99999999999.99
ExcessAmtNumberTotal excess wages for the quarter.
Size Range: ..99999999999.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 UITR1 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 UITR1 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 UITR1.
IdstringReturns the validation error ID.
NamestringName of the validation error.
ErrorRecordsobject[]Provides detailed information about the error status of Form UITR1 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​

{
  "SubmissionId": "0199c873-73a6-777d-a932-0453fa4b9b13",
  "StateUIRecords": [
    {
      "RecordId": "b8da099b-71c6-43bd-9932-94044458a68e",
      "SequenceId": "001",
      "ReturnHeader": {
        "TaxYr": "2026",
        "Qtr": "Q1",
        "Business": {
          "BusinessId": null,
                              "BusinessNm": "Snowdaze LLC",
                    "FirstNm": null,
                    "MiddleNm": null,
                    "LastNm": null,
                    "Suffix": null,
                    "PayerRef": "Snow113123",
                    "TradeNm": "Iceberg Icecreams",
                    "IsDefaultBusiness": true,
                    "IsEIN": true,
                    "EINorSSN": "23-4876856",
                    "Email": "james@sample.com",
                    "ContactNm": "James Smith",
                    "Phone": "6534567890",
                    "PhoneExtn": "123",
                    "Fax": "9834567890",
                    "BusinessType": "ESTE",
                    "SigningAuthority": {
                        "Name": "James Smith",
                        "Phone": "9934567890",
                        "BusinessMemberType": "ADMINISTRATOR"
                    },
                    "KindOfEmployer": "FEDERALGOVT",
                    "KindOfPayer": "REGULAR941",
                    "IsBusinessTerminated": false,
                    "Form1042SDetails": null,
                    "IsForeign": false,
                    "USAddress": {
                        "Address1": "3576 AIRPORT WAY",
                        "Address2": "UNIT 9",
                        "City": "FAIRBANKS",
                        "State": "AK",
                        "ZipCd": "99709"
                    },
                    "ForeignAddress": null,
                    "ACADetails": null
        }
      },
      "ReturnData": {
        "FormUITR1": {
          "UIIdNum": "12345678",
          "IsNoWageReported": false,
          "TaxRate": "12.5",
          "TotWagesAmt": 2000,
          "TotExcessWageAmt": 2000,
          "TotTaxableWages": 2000,
          "TaxDue": 2000,
          "Interest": 100,
          "LateRepPenalty": 100,
          "CreditOrDebitAmt": 100,
          "BalanceDue": 200,
          "NumOfEmployees": {
            "Month1TotEmployees": 10,
            "Month2TotEmployees": 20,
            "Month3TotEmployees": 30
          },
          "AddEmployeeDetails": [
            {
              "EmpSequenceId": "01",
              "EmployeeId": null,
              "EmpRef": null,
              "SSN": "001456924",
              "FirstNm": "John",
              "MiddleNm": "A",
              "LastNm": "Smith",
              "Suffix": "Sr",
              "IsMonth1": true,
              "IsMonth2": false,
              "IsMonth3": false,
              "IsSeasonal": true,
              "GrossWagesAmt": 1000,
              "TaxableWages": 1000,
              "ExcessAmt": 100
            }
          ],
          "UpdateEmployeeDetails": [
            {
              "EmpSequenceId": "01",
              "EmployeeId": null,
              "EmpRef": null,
              "SSN": "001456924",
              "FirstNm": "John",
              "MiddleNm": "A",
              "LastNm": "Smith",
              "Suffix": "Sr",
              "IsMonth1": true,
              "IsMonth2": false,
              "IsMonth3": false,
              "IsSeasonal": true,
              "GrossWagesAmt": 1000,
              "TaxableWages": 1000,
              "ExcessAmt": 100
            }
          ],
          "DeleteEmployeeDetails": [
            {
              "EmpSequenceId": "01",
              "EmployeeId": null,
              "EmpRef": null,
              "UnitNum": "1",
              "SSN": "001456924",
              "FirstNm": "John",
              "MiddleNm": "A",
              "LastNm": "Smith",
              "Suffix": "Sr",
              "IsMonth1": true,
              "IsMonth2": false,
              "IsMonth3": false,
              "IsSeasonal": true,
              "GrossWagesAmt": 1000,
              "TaxableWages": 1000,
              "ExcessAmt": 100
            }
          ]
        }
      }
    }
  ]
}

Response JSON​

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

{
  "StatusCode": "200",
  "StatusName": "Ok",
  "StatusMessage": "Successful API call",
  "SubmissionId": "019c6fa4-9b69-76ac-b2f5-3a00bca618eb",
  "SuccessRecords": [
      {
          "SequenceId": "001",
          "BusinessId": "162050c1-8418-4c17-bf81-72ea5ff7fb3a",
          "PayerRef": "PayerRef847e",
          "RecordId": "019c6fa4-a149-73dd-8ad4-7c8c3b118d36",
          "FormType": "UITR1",
          "EmployeeData": [
              {
                  "EmployeeId": "f9fa477c-dc13-4388-969d-b8375c65940d",
                  "EmpRef": "324234"
              },
              {
                  "EmployeeId": "e776a8d4-e966-407f-b546-845d84a4dd5d",
                  "EmpRef": "48758"
              }
          ],
          "Status": "CREATED",
          "StatusTs": "2026-02-18 02:26:26 -05:00",
          "Info": null,
          "Errors": null
      }
  ],
  "ErrorRecords": null,
  "Errors": null
}