Skip to main content
Version: 1.7.3

Create

Create

Use this endpoint to create Form CT UC-2 (Connecticut Quarterly Tax and Wage Report) for an employer (payer), reporting quarterly wages, taxable wages, and unemployment insurance (UI) contributions due, along with required employee wage details for the corresponding quarter.

Form CT UC-2 must be filed every quarter, even if no wages were paid.

POSTStateFilings/CTUI/Create
Run in Postman

Request Body

FieldTypeDescription
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 UC-2 is to be filed.
Allowed values

2025,2026

QtrstringThe quarter for which the Form UC-2 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: 5
Allowed values

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

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

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.
FormUC2ObjectIdentifies the Form UC-2 data.
UIIdNumstringEmployer ID number.
Sample format: XX-XXXXX-X-XX
IsNoWageReportedBooleanWhen true, indicates that no wage is reported in this quarter.
TaxRateNumberTax rate for the quarter.
For Tax Year 2026
Size Range: 0.011-0.099
For Tax Year 2025
Size Range: 0.011-0.089
TotWagesNumberTotal wages reported for the quarter.
Size Range: ..99999999999.99
TotExcessWagesNumberExcess wages for the quarter.
Size Range: ..99999999999.99
TotTaxableWagesNumberTaxable wages for the quarter.
Size Range: ..99999999999.99
TaxDueNumberTax due for the quarter.
Size Range: 0-99999999999.99
InterestNumberOptional Interest for the quarter.
Size Range: 0-99999999999.99
LateFilingPenaltyNumberOptional Late filing penalty for the quarter.
PenaltyNumberOptional Penalty for the quarter.
Size Range: 0-99999999999.99
NumOfEmployeesObjectIdentifies the total number of employees for the quarter.
Month1EmployeesstringTotal number of employees in month 1 of the quarter.
Size Range: 0-9999999
Month2EmployeesstringTotal number of employees in month 2 of the quarter.
Size Range: 0-9999999
Month3EmployeesstringTotal number of employees in month 3 of the quarter.
Size Range: 0-9999999
EmployeeDetailsObjectObject to identify the Connecticut employee details.
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"

GrossWagesNumberGross wages of the employee.
Size Range: ..99999999999.99

Response Body

Field NameTypeDescription
SubmissionIdGuidUnique identifier for a submission.
SuccessRecordsobject[]Provides detailed information about the success status of Form UC-2 records.
SequenceIdstringA unique reference ID for the submission, 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 UC-2 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 UC-2.
IdstringReturns the validation error ID.
NamestringName of the validation error.
ErrorRecordsobject[]Provides detailed information about the error status of Form UC-2 records.
SequenceIdstringA unique reference ID for the submission, 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 Form UC2 with US Address

{
  "StateUIRecords": [
      {
          "SequenceId": "001",
          "ReturnHeader": {
              "TaxYr": "2026",
              "Qtr": "Q1",
              "Business": {
                  "BusinessNm": "Snowdaze LLC",
                  "IsEIN": true,
                  "EINorSSN": "45-1233221",
                  "BusinessType": "PART",
                  "SigningAuthority": {
                      "Name": "John",
                      "Phone": "3231231232",
                      "BusinessMemberType": "OWNER"
                  },
                  "IsForeign": false,
                  "USAddress": {
                      "Address1": "280 Trumbull St",
                      "Address2": "Suite 1200",
                      "City": "Hartford",
                      "State": "CT",
                      "ZipCd": "06103"
                  }
              }
          },
          "ReturnData": {
              "FormUC2": {
                  "UIIdNum": "05-61345-5-46",
                  "IsNoWageReported": false,
                  "TaxRate": "0.05",
                  "TotWages": 20000,
                  "TotExcessWages": 6000.00,
                  "TotTaxableWages": 14000.00,
                  "TaxDue": 7.00,
                  "Penalty": 0.00,
                  "Interest": 0.00,
                  "LateFilingPenalty": 0.00,
                  "NumOfEmployees": {
                      "Month1TotEmployees": 2,
                      "Month2TotEmployees": 2,
                      "Month3TotEmployees": 2
                  },
                  "EmployeeDetails": [
                      {
                          "EmpSequenceId": "01",
                          "EmployeeId": null,
                          "EmpRef": null,
                          "SSN": "001-45-6924",
                          "FirstNm": "John",
                          "MiddleNm": null,
                          "LastNm": "Smith",
                          "Suffix": "Jr",
                          "GrossWages": 10000.00
                      },
                      {
                          "EmpSequenceId": "02",
                          "EmployeeId": null,
                          "EmpRef": null,
                          "UnitNum": "258",
                          "SSN": "001-25-6925",
                          "FirstNm": "Caleb",
                          "MiddleNm": null,
                          "LastNm": "Lesnar",
                          "Suffix": "Jr",
                          "GrossWages": 10000.00
                      }
                  ]
              }
          }
      }
  ]
}

Response JSON​

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

{
  "StatusCode": "200",
  "StatusName": "Ok",
  "StatusMessage": "Successful API call",
  "SubmissionId": "019fa484-4e8a-7695-bbae-3b0fbe5d63d8",
  "SuccessRecords": [
      {
          "SequenceId": "001",
          "BusinessId": "b34d8206-e0b6-4473-89df-7b875f3a4fcf",
          "PayerRef": null,
          "RecordId": "019fa484-54c2-7100-8bdd-cd212cec98f1",
          "FormType": "UC2",
          "EmployeeData": [
              {
                  "EmployeeId": "a8bf9020-7687-4549-bfbe-3940e4acc4b3",
                  "EmpRef": null
              }
          ],
          "Status": "CREATED",
          "StatusTs": "2026-07-27 12:59:23 -04:00",
          "Info": null,
          "Errors": null
      }
  ],
  "ErrorRecords": null,
  "Errors": null
}