Get
Get
Use this endpoint to retrieve the information of a previously created IL 3/40 form for the corresponding employer (payer). Your request JSON must include the corresponding SubmissionId and the RecordId (optional) for the forms.
POST StateFilings/ILUI/Get Request Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier of a submission. |
| RecordId | Guid | An unique identifier generated by TaxBandits when a IL 3/40 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 IL 3/40 return is created. |
| ReturnHeader | Object | Contains business information. |
| TaxYear | String | The tax year for which the Form IL340 is to be filed. |
| Qtr | String | The quarter for which the Form IL340 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. |
| FormIL340 | Object | Identifies the Form IL 3/40 data. |
| IsFinalReturn | Boolean | If true, identifies that the business has ceased operations or had no employees during that quarter. |
| IsNoWageRptd | Boolean | When true, indicates that no wage is reported in this quarter. |
| UIIdNum | String | Employer's Illinois Unemployment Account Number. |
| EmployerTaxType | String | Employment tax type. |
| TotGrossWages | Number | Total wages paid for the quarter. |
| TotExcessWages | Number | Total excess wages paid for the quarter. |
| TotTaxableWages | Number | Total taxable wages paid for all employees in the quarter that is subject to Illinois Unemployment Insurance. |
| UITaxRate | Number | Tax rate for the quarter. |
| UITaxDue | Number | Contribution amount for the quarter. |
| Interest | Number | Interest due for the quarter (2% per month after the due date). |
| LateFilingPenalty | Number | Late filing penalty for the quarter. |
| UnderPayment | Number | Late filing penalty for the quarter. |
| OverPayment | Number | Late filing penalty for the quarter. |
| TotUIDue | Number | Total remittance due 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. |
| EmployeeDetails | 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. |
| 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. |
| Address | object | Address information 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/ilui/Get?SubmissionId=01a0e764-91af-77bb-9989-cf6132651091&RecordId=01a0e764-98ad-74f3-ae90-d846c08a696f"
Response JSON
- 200
Success Response - This is a sample response for successful API requests.
{
"SubmissionId": "01a0e764-91af-77bb-9989-cf6132651091",
"StateUIRecords": [
{
"SequenceId": "001",
"RecordId": "01a0e764-98ad-74f3-ae90-d846c08a696f",
"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": {
"FormIL340": {
"IsFinalReturn": false,
"IsNoWageRptd": false,
"UIIdNum": "8934567",
"EmployerTaxType": "TAXABLE_EMPLOYER",
"UITaxRate": 1,
"TotGrossWages": 2000,
"TotExcessWages": 2000,
"TotTaxableWages": 0,
"UITaxDue": 0,
"Interest": 100,
"LateFilingPenalty": 100,
"UnderPayment": 100,
"OverPayment": 100,
"TotUIDue": 200,
"NumOfEmp": {
"TotMonth1Emp": 2,
"TotMonth2Emp": 2,
"TotMonth3Emp": 2
},
"EmployeeDetails": [
{
"EmployeeSequenceId": "01",
"EmployeeId": "62b3650b-d22b-4cf0-b8b2-515047456cbf",
"EmployeeRef": null,
"SSN": "313-21-6277",
"FirstNm": "John",
"MiddleNm": "A",
"LastNm": "Smith",
"Suffix": "Sr",
"GrossWages": 1000,
"Address": {
"Address1": "12 Main St",
"Address2": "CC Avenue",
"City": "Rock Hill",
"ProvinceOrState": "SC",
"ZipCd": "29730",
"Country": "US"
}
},
{
"EmployeeSequenceId": "02",
"EmployeeId": "7f38051b-a6aa-4eea-ae0e-e9d09ae8eb06",
"EmployeeRef": null,
"SSN": "843-81-2651",
"FirstNm": "Marcellus",
"MiddleNm": "A",
"LastNm": "Smith",
"Suffix": "Sr",
"GrossWages": 1000,
"Address": {
"Address1": "12 Main St",
"Address2": "CC Avenue",
"City": "Rock Hill",
"ProvinceOrState": "SC",
"ZipCd": "29730",
"Country": "US"
}
}
]
}
}
}
],
"Errors": null
}