Get
Get
Use this endpoint to retrieve the information of a previously created TQ01C form for the corresponding employer (payer). Your request JSON must include the corresponding SubmissionId and the RecordId (optional) for the forms.
GET StateFilings/AKUI/Get Request Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier of a submission. |
| RecordId | Guid | An unique identifier generated by TaxBandits when a TQ01C return is created. Mention the return's Record ID that you want to get. |
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. |
| RecordId | Guid | A unique identifier generated by TaxBandits when a TQ01C return is created. |
| ReturnHeader | Object | Contains business information. |
| TaxYear | String | The tax year for which the Form TQ01C is to be filed. |
| Qtr | String | The quarter for which the Form TQ01C 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 | The 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. |
| 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. |
| FormTQ01C | Object | Identifies the Form TQ01C data. |
| UIIdNum | String | Employer's Alaska Unemployment Account Number. |
| IsNoWageRptd | Boolean | When true, indicates that no wage is reported in this quarter. |
| IsOutOfStateWages | Boolean | When true, indicates that wage is reported in other states. |
| TotGrossWages | Number | Total wages paid for the quarter. |
| TotExcessWage | Number | Total excess wages paid for the quarter. |
| TotTaxableWages | Number | Total taxable wages paid for all employees in the quarter that is subject to Alaska Unemployment Insurance. |
| UITaxRate | Number | Tax rate for the quarter. |
| UITaxDue | Number | Total employer's tax due for the quarter. |
| EmpUITaxDue | Number | Total employee's tax due for the quarter. |
| TotUITaxDue | Number | Total tax due for the quarter. |
| TaxPaid | Number | Total amount remitted for this 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. |
| EmpDetails | Object[] | Object to identify the employee details. |
| EmployeeSequenceId | string | A unique number to identify this record. |
| EmployeeId | 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 | Total gross wages reported for the quarter. |
| GeogrCd | String | Employee's Geographic code. |
| OccupationCd | string | Employee's SOC (6-digit) or O-NET (8-digit) code. |
| Address | object | Address of the employee. |
| Address1 | string | Street address or PO Box of the employee. |
| Address2 | string | Suite or apartment number of the employee. |
| City | string | City of the employee. |
| ProvinceOrState | string | Province or state name of the employee. |
| ZipCd | string | ZIP code of the employee. |
| Country | string | 2-character country code of the employee. |
| Errors | Object[] | Shows detailed error information. |
| Id | string | Returns the validation error ID. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
Request JSON
statefilings/akui/get?SubmissionId=01a0e6c9-bf61-7258-9183-9a6804594445&RecordId=01a0e6c9-c4c6-769f-bfec-0811d66dd58b
Response JSON
- 200
- 400
- 401
Success Response - This is a sample response for successful API requests.
{
"SubmissionId": "01a0e6c9-bf61-7258-9183-9a6804594445",
"StateUIRecords": [
{
"SequenceId": "001",
"RecordId": "01a0e6c9-c4c6-769f-bfec-0811d66dd58b",
"ReturnHeader": {
"Qtr": "Q3",
"TaxYear": "2026",
"Business": {
"BusinessId": "19fc85b0-7bf6-45d3-8bde-659e007a8047",
"PayerRef": null,
"IsDefaultBusiness": true,
"TINDetails": {
"Format": "PLAIN_TIN",
"TINType": "EIN",
"TIN": "48-7789899"
},
"BusinessNm": "Snowdaze LLC",
"DBADetails": {
"DBANm": "Iceberg Icecreams",
"DBARef": "DBA1001",
"DBAId": "25484EBF-A993-487F-998D-5EDC76718222",
"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": {
"FormTQ01C": {
"UIIdNum": "45354345",
"IsNoWageRptd": false,
"IsOutOfStateWages": true,
"TotGrossWages": 1000,
"TotTaxableWages": 500,
"TotExcessWages": 500,
"UITaxRate": 1,
"UITaxDue": 5,
"EmpUITaxDue": 2.5,
"TotUITaxDue": 7.5,
"TaxPaid": 1000,
"NumOfEmp": {
"TotMonth1Emp": 1,
"TotMonth2Emp": 1,
"TotMonth3Emp": 1
},
"EmpDetails": [
{
"EmployeeSequenceId": "11",
"EmployeeId": "cbc66e32-9511-4785-996e-462d9002a268",
"EmployeeRef": null,
"SSN": "761-40-5692",
"FirstNm": "John",
"MiddleNm": "Joe",
"LastNm": "Smith",
"Suffix": null,
"GrossWages": 1000,
"GeogrCd": "31",
"OccupationCd": "00-2111",
"Address": {
"Address1": "12 Main St",
"Address2": "CC avenue",
"City": "Rock Hill",
"ProvinceOrState": "SC",
"ZipCd": "29730",
"Country": "US"
}
}
]
}
}
}
],
"Errors": null
}
Bad Request Response - You'll get the below response when your API requests contain any validation errors.
{
"SubmissionId": null,
"StateUIRecords": [],
"Errors": [
{
"Id": "S00-000097",
"Name": "SubmissionId",
"Message": "SubmissionId is required."
}
]
}
Unauthorized Response - You'll get the below response when your API requests don't contain valid authentication credentials.
{
"Errors": [
{
"Id": "AUTH-100018",
"Name": "Authorization",
"Message": "JWT EXPIRED"
}
]
}