Skip to main content
Version: 1.7.3

Update

Update

Use this endpoint to update the information for existing RT-6 forms already created for the business.

Note:

You cannot update a return once it has been transmitted.

PUTStateFilings/FLUI/Update

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 RT-6 is to be filed.
Allowed values

"2025"

QtrstringThe quarter for which the Form RT-6 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.
FormRT6ObjectIdentifies the Form RT-6 data.
IsDiffMailAddBooleanWhen true, identifies the business has a different mailing address
MailAddressObjectIf IsDiffMailAdd is true, pass the mailing 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
UIIdNumstringEmployer ID number.
Sample format: XXXXXXX
IsFinalReturnBooleanWhen true, indicates that it is a final return
DateOperationCeasedstringEnter the date of the operation that ceasedFormat: MM/DD/YYYY or MM-DD-YYYY
L1NumOfEmployeesObjectIdentifies 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
L2UITotWagesNumberTotal wages reported for the quarter.
Size Range: ..99999999999.99
L3ExcessWagesNumberExcess wages for the quarter.
Size Range: ..99999999999.99
L4UITaxableWagesNumberTaxable wages for the quarter.
Size Range: ..99999999999.99
TaxRateNumberTax rate for the quarter.
Size Range: 1-100
L5TaxDueNumberTax due for the quarter.
Size Range: 0-999999999.99
L6UIPenaltyNumberOptional Penalty for the quarter.
Size Range: 0-999999999.99
L7UIInterestNumberOptional Interest for the quarter.
Size Range: 0-999999999.99
L8InstallmentFeeNumberOptional Installment fee for the quarter.
Size Range: 0-999999999.99
L9aUITotDueNumberTotal tax due for the quarter
Size Range: 0-999999999.99
L9bAmountEnclosedNumber
IsSoleHHEmploymentOnlyBooleanWhen true, indicates filing as a sole proprietor. Is this applicable only to domestic (household) employment
IsOutOfStateWagesBooleanWhen true, indicates that the business has out of state wages
AddEmployeeDetailsObjectObject to add Employee to the RT-6 form
FLEmployeesObjectObject to identify the Florida employee details.
EmpSequenceIdstringA unique number to identify this record.
Size Range: ..10
EmployeeIdGuidOptional A unique ID generated by TaxBandits after the return is createdand 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
FLGrossWagesNumberFlorida Gross wages of the employee.
Size Range: ..99999999999.99
FLTaxableWagesNumberFloridaTaxable wages of the employee.
Size Range: ..99999999999.99
EduEmpWagesNumberEmployee’s Contracted to Educational Institutions Wages
Size Range: ..99999999999.99
OutOfStateEmployeesObjectObject to identify the Florida employee details.
EmpSequenceIdstringA unique number to identify this record.
Size Range: ..10
EmployeeIdGuidOptional A unique ID generated by TaxBandits after the return is createdand 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"

FLGrossWagesNumberFlorida Gross wages of the employee.
Size Range: ..99999999999.99
FLTaxableWagesNumberFloridaTaxable wages of the employee.Size Range: ..99999999999.99
OutOfStateGrossWagesNumberOut of state gross wages of the employee.
Size Range: ..99999999999.99
OutOfStateTaxableWagesNumberOut of state taxable wages of the employee.
Size Range: ..99999999999.99
EduEmpWagesNumberEmployee’s Contracted to Educational Institutions Wages
Size Range: ..99999999999.99
TotGrossWagesNumberTotal Gross wages of the employee.
Size Range: ..99999999999.99
TotTaxableWagesNumberTaxable wages of the employee.
Size Range: ..99999999999.99
TotOutOfStateGrossWagesNumberTotal out-of-state gross wages of the employee.
Size Range: ..99999999999.99
TotOutOfStateTaxableWagesNumberTotal out-of-state taxable wages of the employee.
Size Range: ..99999999999.99
RemoveFLEmployeesDetailsObject[]Object to delete employees from the RT-6 form
EmployeeIdGuidOptional A unique ID generated by TaxBandits after the return is created and returned in the response.
EmpRefstringA unique identifier of the employee.
RemoveOutOfStateEmployeesDetailsObject[]Object to delete employees from the RT-6 form
EmployeeIdGuidOptional A unique ID generated by TaxBandits after the return is created and returned in the response.
EmpRefstringA unique identifier of the employee.
TotGrossWagesNumberTotal Gross wages of the employee.
Size Range: ..99999999999.99
TotTaxableWagesNumberTaxable wages of the employee.
Size Range: ..99999999999.99
TotOutOfStateGrossWagesNumberTotal out-of-state gross wages of the employee.
Size Range: ..99999999999.99
TotOutOfStateTaxableWagesNumberTotal out-of-state taxable wages of the employee.
Size Range: ..99999999999.99

Response Body

| Field | Type | Description |

FieldTypeDescription
SubmissionIdGuidUnique identifier for a submission.
SuccessRecordsobject[]Provides detailed information about the success status of Form RT6 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 RT6 return is created.
EmployeeDataobject[]Object to identify the employee details
EmployeeIdGuidReturns the unique identifier of the employee generated by TaxBandits.
EmpRefStringReturns the unique reference of the employee
RemoveFLEmployeesDetailsObject[]Object to identify the Florida employee details removed from the return
EmployeeIdGuidReturns the unique identifier of the employee generated by TaxBandits.
EmpRefStringReturns the unique reference of the employee
StatusstringReturns the employee status.
StatusTsstringReturns the date and time when the employee was removed from the return
InfostringProvides additional information about the employee status
RemoveOutOfStateEmployeesDetailsObject[]Object to identify the out of state employee details removed from the return
EmployeeIdGuidReturns the unique identifier of the employee generated by TaxBandits.
EmpRefStringReturns the unique reference of the employee
StatusstringReturns the employee status.
StatusTsstringReturns the date and time when the employee was removed from the return
InfostringProvides additional information about the employee status
FormTypestringRetruns the type of UI 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 RT6 .
IdstringReturns the validation error ID.
NamestringName of the validation error.
ErrorRecordsobject[]Provides detailed information about the error status of Form RT6 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": "019c6fa4-9b69-76ac-b2f5-3a00bca618eb",
"StateUIRecords": [
{
"SequenceId": "001",
"ReturnHeader": {
"Qtr": "Q4",
"TaxYr": "2025",
"Business": {
"BusinessId": "162050c1-8418-4c17-bf81-72ea5ff7fb3a"
}
},
"ReturnData": {
"RecordId": "019c6fa4-a149-73dd-8ad4-7c8c3b118d36",
"FormRT6": {
"IsDiffMailAdd": true,
"MailAddress": {
"Address1": "12 Main st",
"Address2": "CC avenue",
"City": "Rock Hill",
"State": "SC",
"ZipCd": "29730"
},
"UIIdNum": "4845754",
"IsFinalReturn": true,
"DateOperationCeased": "08-20-2025",
"L1NumOfEmployees": {
"Month1Employees": 10,
"Month2Employees": 20,
"Month3Employees": 30
},
"L2UITotWages": "1600.00",
"L3ExcessWages": "200.00",
"L4UITaxableWages": "1400.00",
"TaxRate": "0.05",
"L5TaxDue": "70",
"L6UIPenalty": "1.00",
"L7UIInterest": "1.00",
"L8InstallmentFee": "5.00",
"L9aUITotDue": "77",
"IsSoleHHEmploymentOnly": true,
"IsOutOfStateWages": true,
"FLEmployees": [
{
"EmployeeId": "e776a8d4-e966-407f-b546-845d84a4dd5d",
"EmployeeSeqId": "01",
"EmpRef": "48758",
"SSN": "676-85-3487",
"FirstNm": "Klaus",
"MiddleNm": "A",
"LastNm": "Thomas",
"Suffix": "jr",
"USAddress": {
"Address1": "71 saint nicholas Dr",
"Address2": null,
"City": "Northpole",
"State": "AK",
"ZipCd": "99705"
},
"FLGrossWages": "800.00",
"FLTaxableWages": "700.00",
"EduEmpWages": "700.00"
}
],
"OutOfStateEmployees": [
{
"EmployeeId": "f9fa477c-dc13-4388-969d-b8375c65940d",
"EmpSequenceId": "02",
"EmpRef": "324234",
"SSN": "659-52-5123",
"FirstNm": "Henry",
"MiddleNm": "A",
"LastNm": "Thomas",
"Suffix": "jr",
"USAddress": {
"Address1": "12 Main St",
"Address2": "CC avenue",
"City": "Rock Hill",
"State": "SC",
"ZipCd": "29730"
},
"FLGrossWages": "800.00",
"FLTaxableWages": "700.00",
"OutOfStateGrossWages": "400.00",
"OutOfStateTaxableWages": "400.00",
"EduEmpWages": "700.00"
}
],
"RemoveFLEmployeesDetails": [
{
"EmployeeId": null,
"EmpRef": "Payee001"
}
],
"RemoveOutOfStateEmployeesDetails": [
{
"EmployeeId": null,
"EmpRef": "Payee002"
}
],
"TotGrossWages": "1600.00",
"TotTaxableWages": "1400.00",
"TotOutOfStateGrossWages": "400",
"TotOutOfStateTaxableWages": "400"
}
}
}
]
}

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"
}
],
"RemoveFLEmployeeDetails": [
{
"EmployeeId": "4e288a51-e54b-464d-afc8-23790a8beb5a",
"EmpRef": "7598",
"Status": "Removed",
"StatusTs": "2025-10-09 06:10:34 -04:00",
"Info": "Employee Removed successfully"
}
],
"RemoveOutOfStateEmployeesDetails": [
{
"EmployeeId": "4e288a51-e54b-464d-afc8-23790a8beb5a",
"EmpRef": "7598",
"Status": "Removed",
"StatusTs": "2025-10-09 06:10:34 -04:00",
"Info": "Employee Removed successfully"
}
],
"FormType": "RT6",
"Status": "CREATED",
"StatusTs": "2025-10-09 06:10:34 -04:00",
"Info": null,
"Errors": null
}
],
"ErrorRecords": null,
"Errors": null
}