Version: 1.7.3

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

Run in Postman

Request Body

Field	Type	Description
SubmissionId	Guid	Unique identifier created by TaxBandits for each submission. Not required when you are creating a return.
StateUIRecords	Object []	Object to identify the records.
SequenceId	String	A unique identifier for this record. Size Range: ..10
ReturnHeader	Object	Contains information about the Business details.
TaxYr	string	The tax year for which the Form RT-6 is to be filed. Allowed values "2025"
Qtr	string	The quarter for which the Form RT-6 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 provided in the response from theBusiness CREATE endpoint.
BusinessNm	string	Name of the business. Size Range: ..75
TradeNm	string	Optional Name under which the business operates. Size Range: ..75
IsEIN	Boolean	When true, identifies the business with an EIN.
EINorSSN	string	When IsEIN is true, use Employer Identification Number (EIN). When IsEIN isfalse, use Social Security Number (SSN). Size Range: 9-11
Email	string	Optional Email address of the business. Size Range: ..100
ContactNm	string	Optional Name of the person who can be contacted by the IRS. Size Range: ..27
Phone	string	Optional Phone number of the business. Size Range: 10
PhoneExtn	string	Optional Extension of the business phone number. Size Range: ..5
Fax	string	Optional Fax number of the business. Size Range: 10
BusinessType	string	Optional Type of business. Mandatory for 94X series and optional forW-2/1099. Size Range: 4 Allowed values "ESTE", "PART", "CORP", "EORG", "SPRO"
KindOfEmployer	string	Optional Identifies the kind of employer. Mandatory for W-2 and optionalfor 1099-NEC and 94X series. Allowed values "FEDERALGOVT", "STATEORLOCAL501C", "NONGOVT501C", "STATEORLOCALNON501C","NONEAPPLY"
KindOfPayer	string	Optional Identifies the kind of payer. This field is mandatory for W-2 andoptional in 1099-NEC and 94X series. Allowed values "REGULAR941", "REGULAR944", "AGRICULTURAL943", "HOUSEHOLD", "MILITARY", "MEDICAREQUALGOVEM", "RAILROADFORMCT1"
IsBusinessTerminated	Boolean	When true, indicates that the business is terminated.
IsForeign	Object	When true, indicates that the business has a foreign address.
USAddress	object	If IsForeign is false, pass the US address of the business.
Address1	string	Employer/Payer's US address (street or post office box of that locality). Size Range: ..46
Address2	string	Optional Employer/Payer's suite or apartment. Size Range: ..46
City	string	Employer/Payer's city. Size Range: ..50
State	string	Employer/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"
ZipCd	string	Employer/Payer's zip code. Size Range: 5..10
ForeignAddress	Object	If IsForeign is true, pass the foreign address of the business.
Address1	string	Employer/Payer's foreign address (street address or post office box of thatlocality). Size Range: ..50
Address2	string	Optional Employer/Payer's suite or apartment. Size Range: ..50
City	string	Employer/Payer's city. Size Range: ..50
ProvinceOrStateNm	string	Employer/Payer's province or state name. Size Range: ..50
Country	string	Employer/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"
PostalCd	string	Employer/Payer's postal code. Size Range: ..16
ReturnData	Object	Contains the return information.
FormRT6	Object	Identifies the Form RT-6 data.
IsDiffMailAdd	Boolean	When true, identifies the business has a different mailing address
MailAddress	Object	If IsDiffMailAdd is true, pass the mailing address of the business.
Address1	string	Employer/Payer's US address (street or post office box of that locality). Size Range: ..46
Address2	string	Optional Employer/Payer's suite or apartment. Size Range: ..46
City	string	Employer/Payer's city. Size Range: ..50
State	string	Employer/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"
ZipCd	string	Employer/Payer's zip code. Size Range: 5..10
UIIdNum	Object	Employer ID number. Sample format: XXXXXXX
IsFinalReturn	Boolean	When true, indicates that it is a final return
DateOperationCeased	string	Enter the date of the operation that ceasedFormat: MM/DD/YYYY or MM-DD-YYYY
L1NumOfEmployees	Object	Identifies the total number of employees for the quarter.
Month1Employees	string	Total number of employees in month 1 of the quarter. Size Range: 0-9999999
Month2Employees	string	Total number of employees in month 2 of the quarter. Size Range: 0-9999999
Month3Employees	string	Total number of employees in month 3 of the quarter. Size Range: 0-9999999
L2UITotWages	Number	Total wages reported for the quarter. Size Range: ..99999999999.99
L3ExcessWages	Number	Excess wages for the quarter. Size Range: ..99999999999.99
L4UITaxableWages	Number	Taxable wages for the quarter. Size Range: ..99999999999.99
TaxRate	Number	Tax rate for the quarter. Size Range: 1-100
L5TaxDue	Number	Tax due for the quarter. Size Range: 0-999999999.99
L6UIPenalty	Number	Optional Penalty for the quarter. Size Range: 0-999999999.99
L7UIInterest	Number	Optional Interest for the quarter. Size Range: 0-999999999.99
L8InstallmentFee	Number	Optional Installment fee for the quarter. Size Range: 0-999999999.99
L9aUITotDue	Number	Total tax due for the quarter Size Range: 0-999999999.99
IsSoleHHEmploymentOnly	Boolean	When true, indicates filing as a sole proprietor. Is this applicable only to domestic (household) employment
IsOutOfStateWages	Boolean	When true, indicates that the business has out of state wages
FLEmployees	Object	Object to identify the Florida employee details.
EmpSequenceId	string	A unique number to identify this record. Size Range: ..10
EmployeeId	Guid	Optional A unique ID generated by TaxBandits after the return is createdand returned in the response.
EmpRef	string	A unique identifier of the employee.
SSN	string	Employee's Social Security Number (SSN). Size Range: 9-11
FirstNm	string	Employee's first name. Size Range: 15
MiddleNm	string	Optional Employee's middle name. Size Range: 15
LastNm	string	Employee's last name. Size Range: 20
Suffix	string	Optional Employee's suffix. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
USAddress	object	If IsForeign is false, pass the US address of the business.
Address1	string	Employer/Payer's US address (street or post office box of that locality). Size Range: ..46
Address2	string	Optional Employer/Payer's suite or apartment. Size Range: ..46
City	string	Employer/Payer's city. Size Range: ..50
State	string	Employer/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"
ZipCd	string	Employer/Payer's zip code. Size Range: 5..10
FLGrossWages	Number	Florida Gross wages of the employee. Size Range: ..99999999999.99
FLTaxableWages	Number	FloridaTaxable wages of the employee. Size Range: ..99999999999.99
EduEmpWages	Number	Employee’s Contracted to Educational Institutions Wages Size Range: ..99999999999.99
OutOfStateEmployees	Object	Object to identify the Florida employee details.
EmpSequenceId	string	A unique number to identify this record. Size Range: ..10
EmployeeId	Guid	Optional A unique ID generated by TaxBandits after the return is createdand returned in the response.
EmpRef	string	A unique identifier of the employee.
SSN	string	Employee's Social Security Number (SSN). Size Range: 9-11
FirstNm	string	Employee's first name. Size Range: 15
MiddleNm	string	Optional Employee's middle name. Size Range: 15
LastNm	string	Employee's last name. Size Range: 20
Suffix	string	Optional Employee's suffix. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
FLGrossWages	Number	Florida Gross wages of the employee. Size Range: ..99999999999.99
FLTaxableWages	Number	FloridaTaxable wages of the employee.Size Range: ..99999999999.99
OutOfStateGrossWages	Number	Out of state gross wages of the employee. Size Range: ..99999999999.99
OutOfStateTaxableWages	Number	Out of state taxable wages of the employee. Size Range: ..99999999999.99
EduEmpWages	Number	Employee’s Contracted to Educational Institutions Wages Size Range: ..99999999999.99
TotGrossWages	Number	Total Gross wages of the employee. Size Range: ..99999999999.99
TotTaxableWages	Number	Taxable wages of the employee. Size Range: ..99999999999.99
TotOutOfStateGrossWages	Number	Total out-of-state gross wages of the employee. Size Range: ..99999999999.99
TotOutOfStateTaxableWages	Number	Total out-of-state taxable wages of the employee. Size Range: ..99999999999.99

Response Body

Field	Type	Description
SubmissionId	Guid	Unique identifier for a submission.
SuccessRecords	object[]	Provides detailed information about the success status of Form RT-6 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.
BusinessId	Guid	Unique identifier for the business (payer) generated by TaxBandits.
PayerRef	string	Unique identifier for the business (payer) provided by you..
RecordId	Guid	A unique identifier generated by TaxBandits when a Form RT-6 return is created.
FormType	string	Type of form.
Status	string	Returns the record status.
StatusTs	string	Returns the date and time when the return was created.
Info	string	Provides additional information about the return.
Errors	object[]	Displays error information related to the state returns of Form RT-6.
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 RT-6 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.
Message	string	Description 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"
                        }
                    ],
                    "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": "019c6fa4-9b69-76ac-b2f5-3a00bca618eb",
  "SuccessRecords": [
      {
          "SequenceId": "001",
          "BusinessId": "162050c1-8418-4c17-bf81-72ea5ff7fb3a",
          "PayerRef": "PayerRef847e",
          "RecordId": "019c6fa4-a149-73dd-8ad4-7c8c3b118d36",
          "FormType": "RT6",
          "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
}

Multi-status Response - You'll get the below response when multiple statuses are included.

{
  "StatusCode": "300",
  "StatusName": "MultiStatus",
  "StatusMessage": "Multiple statuses are available for the request",
  "SubmissionId": "019c6f97-5d98-766f-acbb-8b94e8288797",
  "SuccessRecords": [
      {
          "SequenceId": "001",
          "BusinessId": "d7073d66-0df9-46c0-a3a3-a235e5abc4ea",
          "PayerRef": "PayerRef8472",
          "RecordId": "019c6f97-5352-729a-9149-fffd6a3b538d",
          "FormType": "RT6",
          "EmployeeData": [
              {
                  "EmployeeId": "66e7dd7a-7dc7-4904-bc1a-db2e33a94664",
                  "EmpRef": "Payref002"
              },
              {
                  "EmployeeId": "a58d0279-42d6-404a-9e7d-88fdf323498a",
                  "EmpRef": "83495"
              }
          ],
          "Status": "CREATED",
          "StatusTs": "2026-02-18 02:11:54 -05:00",
          "Info": null,
          "Errors": null
      }
  ],
  "ErrorRecords": [
      {
          "SequenceId": "002",
          "RecordId": null,
          "Errors": [
              {
                  "Id": "S00-000852",
                  "Name": "StateUIRecords[1].ReturnData.FormRT6.L2UITotWages",
                  "Message": "Invalid gross wages. Gross wages should be sum of all employee's gross wages"
              },
              {
                  "Id": "S00-000917",
                  "Name": "StateUIRecords[1].ReturnData.FormRT6.TotGrossWages",
                  "Message": "Total Gross Wage should be the sum of Florida Total Wages"
              }
          ]
      }
  ],
  "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.

{
  "StatusCode": "400",
  "StatusName": "BadRequest",
  "StatusMessage": "Validation error has occurred",
  "SubmissionId": null,
  "SuccessRecords": null,
  "ErrorRecords": [
      {
          "SequenceId": "001",
          "RecordId": null,
          "Errors": [
              {
                  "Id": "S00-000856",
                  "Name": "StateUIRecords[0].ReturnData.FormRT6.L4UITaxableWages",
                  "Message": "Invalid taxable wages. Taxable wages should be equal to the difference between total wages and excess wages"
              }
          ]
      }
  ],
  "Errors": null
}

Unauthorized Response - You'll get the below response when your API requests don't contain valid authentication credentials.

{
  "StatusCode": 401,
  "StatusMessage": "Unauthorized",
  "StatusName": "Invalid authorization credentials",
  "Errors": [
      {
          "Id": "AUTH-100018",
          "Name": "Authorization",
          "Message": "JWT EXPIRED"
      }
  ]
}

W-9/W-8 Automation

1099 Automation

TIN Matching

W-2 Automation

941/940 Automation

1098-T Automation

ACA Automation

Extension Automation

Gig Software

Payroll Software

Affiliate Software

HOA Software

Reselling Platform

HCM Providers

Property Management

Supported Forms

Update

Update

Request Body

Response Body

Request JSON​

Response JSON​

Request JSON

Response JSON