Get
Get
Use this endpoint to retrieve the information of a previously created TX UI C3 form for the corresponding employer (payer). Your request JSON must include the corresponding SubmissionId and the RecordId (optional) for the forms.
GET StateFilings/TXUI/Get Request Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier created by TaxBandits for each submission. Not required when you are creating a return |
| RecordId | Guid | A unique identifier generated by TaxBandits when a Form C3 return is created. |
Response Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier created by TaxBandits for each submission. |
| StateUIRecords | Object[] | Object to identify the records. |
| SequenceId | String | A unique identifier for this record. Size Range: ..50 |
| ReturnHeader | Object | Contains business information. |
| TaxYear | String | The tax year for which the Form C3 is to be filed. |
| Qtr | String | The quarter for which the Form C3 is to be filed. |
| Business | object | Object to identify the Business Details. |
| BusinessId | Guid | The unique Business ID (Generated by TaxBandits) that is received in the response of the Business CREATE Endpoint. |
| PayerRef | string | The unique identifier for the payer. Can replace BusinessId in future requests. |
| IsDefaultBusiness | Boolean | When set to TRUE, this business will be set as the default across requests that do not specify a business. |
| TINDetails | object | TIN information for the business. |
| Format | string | Specifies how the TIN is passed. |
| TINType | string | Specify the TIN type of the business. |
| TIN | string | The TIN value according to the Format selected. |
| IndividualNm | object | object to identify Individual name |
| FirstNm | string | The first name of the individual. |
| MiddleNm | string | Middle name of the individual. |
| LastNm | string | The last name of the individual. |
| Suffix | string | Suffix of the individual's name. |
| BusinessNm | string | Legal name of the business. |
| NameCtrl | string | Name control of the business as registered with the IRS. |
| DBADetails | object[] | DBA (Doing Business As) information. |
| DBANm | string | Name of the DBA. |
| DBARef | string | Unique identifier for the DBA. |
| DBAId | Guid | TaxBandits-generated DBA identifier. |
| Address | object[] | Address information of the DBA. |
| Address1 | string | Street address or PO Box. |
| Address2 | string | Suite or apartment number. |
| City | string | DBA's city. |
| ProvinceOrState | string | DBA's province or state name. |
| Zipcd | string | DBA's ZIP code. |
| Country | string | DBA's 2-character country code. |
| string | Email address of the Business. | |
| Address | object | Primary address of the business. |
| Address1 | string | Street address or PO Box of the business. |
| Address2 | string | Suite or apartment number of the business. |
| City | string | City of the business. |
| ProvinceOrState | string | Province or state name of the business. |
| ZipCd | string | ZIP code of the business. |
| Country | string | 2-character country code of the business. |
| ContactDetails | object[] | Details of the person the IRS can contact regarding the given business. |
| FirstNm | string | First name of the contact person. |
| MiddleNm | string | Middle name of the contact person. |
| LastNm | string | Last name of the contact person. |
| Suffix | string | The suffix of the contact person. |
| Phone | string | Phone number of the contact person. |
| PhoneExtn | string | Phone extension number. |
| string | Email address of the contact person. | |
| Fax | string | Fax number of the contact person. |
| ReturnData | Object | Contains the return information. |
| BusinessType | String | Legal structure of the business. |
| SigningAuthority | Object | Details of the person authorized to sign the return. Mandatory for 94x forms. |
| FirstNm | String | First name of the signatory. |
| MiddleNm | String | Middle name of the signatory. |
| LastNm | String | Last name of the signatory. |
| Suffix | String | The suffix of the signatory. |
| Phone | String | Phone number of the signatory |
| PhoneExtn | String | Phone extension number of the signatory. |
| BusinessMemberType | String | Title or role of the signatory. |
| ReturnData | Object | Contains the return information. |
| FormC3 | Object | Identifies the Form C3 data. |
| UIIdNum | string | Employer ID number. |
| CountyCd | string | Employer's county code |
| UITaxRate | Number | Tax rate for the quarter. |
| NAICSCd | Number | North American Industry Classification System code that best classifies the employer. |
| IsNoWageRptd | Boolean | When true, indicates that no wages were reported for the quarter. |
| NumOfEmp | Object | Identifies the total number of employees for the quarter. |
| TotMonth1Emp | string | Total number of employees in month 1 of the quarter. |
| TotMonth2Emp | string | Total number of employees in month 2 of the quarter. |
| TotMonth3Emp | string | Total number of employees in month 3 of the quarter. |
| MaxEmpCounty | string | County code of the county in which there were greatest number of employees. |
| NumOfOutOfCounty | Number | Number of employees in more than one county in texas |
| IsOutOfStateWages | Boolean | When true, it identifies that wages exist from another state. |
| TotGrossWages | Number | Total gross wages reported for the quarter. |
| TotTaxableWages | Number | Taxable wages for the quarter. |
| UITaxDue | Number | Tax due for the quarter. |
| Interest | Number | Interest for the quarter. |
| Penalty | Number | Penalty for the quarter. |
| PrevQtrAdj | Number | Balance due from prior periods |
| TotUIDue | Number | Total tax due for the quarter |
| EmpDetails | Object | Object to identify the employee details. |
| EmployeeSequenceId | string | A unique number to identify this record. |
| EmpId | Guid | A unique ID generated by TaxBandits after the return is created and returned in the response. |
| EmployeeRef | string | A unique identifier of the employee. |
| SSN | string | Employee's Social Security Number (SSN). |
| FirstNm | string | Employee's first name. |
| MiddleNm | string | Employee's middle name. |
| LastNm | string | Employee's last name. |
| Suffix | string | Employee's suffix. |
| GrossWages | Number | Gross wages of the employee. |
| TaxableWages | Number | Taxable wages of the employee. |
| ExcessWages | Number | Excess wages of the employee. |
| OutOfStateTaxableWages | Number | Out of state taxable wages of the employee. |
| Id | string | Returns the validation error Id |
| Name | string | Name of the validation error |
| Message | string | Description of the validation error |
Request JSON
"statefilings/txui/get?SubmissionId=01a0e7e9-75b0-72ac-bd71-fa19b230fb11&RecordId=01a0e7e9-7c7f-7420-9030-d0071e85df2b"
Response JSON
- 200
Success Response - This is a sample response for successful API requests.
{
"SubmissionId": "01a0e7e9-75b0-72ac-bd71-fa19b230fb11",
"StateUIRecords": [
{
"SequenceId": "001",
"RecordId": "01a0e7e9-7c7f-7420-9030-d0071e85df2b",
"ReturnHeader": {
"Qtr": "Q3",
"TaxYear": "2026",
"Business": {
"BusinessId": "339a0fee-9318-4058-9c7a-f24887e10a2f",
"PayerRef": null,
"IsDefaultBusiness": true,
"TINDetails": {
"Format": "PLAIN_TIN",
"TINType": "EIN",
"TIN": "45-8982092"
},
"BusinessNm": "Snowdaze LLC",
"DBADetails": {
"DBANm": "Iceberg Icecreams",
"DBARef": "DBA1001",
"DBAId": "FD33D409-DCAD-4ACA-BB52-092EB78A2620",
"Address": {
"Address1": "123 Main St",
"Address2": "Suite 1001",
"City": "Rock Hill",
"ProvinceOrState": "SC",
"ZipCd": "29730",
"Country": "US"
}
},
"Address": {
"Address1": "123 Main St",
"Address2": "Suite 1001",
"City": "Rock Hill",
"ProvinceOrState": "SC",
"ZipCd": "29730",
"Country": "US"
},
"ContactDetails": {
"FirstNm": "James",
"MiddleNm": "A",
"LastNm": "Anderson",
"Suffix": "Jr",
"Phone": "(803) 555-1234",
"PhoneExtn": "101",
"Email": "contact@snowdaze.com",
"Fax": "(803) 555-5678"
},
"BusinessType": "ESTE",
"SigningAuthority": {
"FirstNm": "Ambrane",
"MiddleNm": "A",
"LastNm": "Cavil",
"Suffix": "Jr",
"Phone": "(803) 555-1000",
"PhoneExtn": "111",
"BusinessMemberType": "ADMINISTRATOR"
},
"KindOfEmployer": null,
"KindOfPayer": null
}
},
"ReturnData": {
"FormC3": {
"UIIdNum": "12-345678-0",
"CountyCd": "227",
"UITaxRate": 10,
"NAICSCd": "123431",
"IsNoWageRptd": false,
"NumOfEmp": {
"TotMonth1Emp": 1,
"TotMonth2Emp": 1,
"TotMonth3Emp": 1
},
"MaxEmpCounty": "113",
"NumOfOutOfCounty": 3,
"IsOutOfStateWages": true,
"TotGrossWages": 1000.12,
"TotTaxableWages": 1000.01,
"UITaxDue": 100,
"Interest": 1000.66,
"Penalty": 300.98,
"PrevQtrAdj": 300.67,
"TotUIDue": 1702.31,
"EmpDetails": [
{
"EmployeeSequenceId": "11",
"EmployeeId": "396b6972-31b8-4cdf-b782-89852a96b2f6",
"EmployeeRef": "Payee01",
"SSN": "761-45-6924",
"FirstNm": "Michael",
"MiddleNm": "Alan",
"LastNm": "Johnson",
"Suffix": null,
"Address": {
"Address1": "500 W 2nd St",
"Address2": "Apt 301",
"City": "Austin",
"ProvinceOrState": "TX",
"ZipCd": "78701",
"Country": "US"
},
"GrossWages": 1000.12,
"OutOfStateTaxableWages": 100
}
]
}
}
}
],
"Errors": null
}