Get
Get
Use this endpoint to retrieve the information of a previously created DE9/DE9-C form for the corresponding business. Your request JSON must include the corresponding SubmissionId and the RecordId (optional) for the forms.
GET StateFilings/CAWHUI/Get Request Params
| 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 DE-9/9C 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. Not required when you are creating a return. |
| StateWHUIRecords | Object [] | Object to create DE9/9Cs |
| SequenceId | String | A unique number given by an inbound application to identify failed records. Size Range: ..10 |
| ReturnHeader | Object | Identifies the supporting details of Form DE9/9C. |
| TaxYr | String | The tax year for which Form DE9/9C needs to be filed.Allowed values2025 |
| Qtr | String | The quarter for which the Form DE9/9C is to be filed.Allowed values"Q1", "Q2", "Q3", "Q4" |
| BusinessId | String | Optional Use the unique BusinessId (Generated by TaxBandits) you received in the response of the Business CREATE Endpoint. If you do not have a BusinesId, ignore the field. By giving the BusinessId, you do not have to provide all the business information again. |
| Business | Object | The details of the business you’re filing for. |
| BusinessNm | String | Name of the business. Size Range: ..75 |
| PayerRef | string | Optional A unique identifier for each payer completing their information. This identifier can be used in future references of the payer in the API. Size Range: ..50 |
| TradeNm | String | Optional Name under which the business operates. Size Range: ..75 |
| IsEIN | Boolean | When true, identifies the business with an EIN. |
| EINorSSN | String | Use Employer Identification Number (EIN). Size Range: 9-11 |
| String | Email address of the business. Size Range: ..100 | |
| IsForeign | Boolean | When true, identifies the business as having a foreign address. |
| USAddress | Object | If IsForeign is false, pass the US address of the business. |
| Address1 | String | Employer/Payer’s US address (street address or post office box). 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. Size Range: 2 Allowed values"AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", etc. |
| 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). 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", etc. |
| PostalCd | String | Employer/Payer’s postal code. Size Range: ..16 |
| ReturnData | Object[] | Identifies the Form DE9/9-C data. |
| FormDE9 | Object | California withholding/UI tax return. |
| AccNum | String | California withholding account number. Size Range: 8 Allowed values"99999999" |
| BranchCd | String | Branch Code is to identify a specific business location or branch under the given account number. Size Range:..3 Allowed values"999" |
| IsNoWageReported | Boolean | If true identifies that the no wages have been paid for the quarter |
| IsNoEmpOrBusienssClosed | Boolean | If true identifies that the business has ceased operations or had no employees during that quarter. |
| BusinessClosedDt | String | Date on which business has ceased operations or had no employees during that quarter. Enter the date in valid format MM/DD/YYYY or MM-DD-YYYY or M/D/YYYY or M-D-YYYY |
| TaxableWages | Number | Total subject wages paid for the quarter. Size Range: 0-9999999999.99 |
| UIRate | Number | Unemployment Insurance (UI) rate Size Range: 0 -100 |
| UITaxableWagesAmt | Number | Unemployment Insurance (UI) wages for the quarter Size Range: 0-9999999999.99 |
| TotUIContribAmt | Number | Employer's contributions on Unemployment Insurance for the quarter Size Range: 0-9999999999.99 |
| ETTRate | Number | Employment Training Tax (ETT) rate Size Range: 0 -100 |
| TotETTContribAmt | Number | Employer's contributions on Employment Training Tax for the quarter Size Range: 0-9999999999.99 |
| SDIRate | Number | State Disability Insurance (SDI) rate Size Range: 0 -100 |
| SDITaxableWagesAmt | Number | State Disability Insurance (SDI) wages for the quarter Size Range: 0-9999999999.99 |
| TotSDIContribAmt | Number | Employer's contributions on State Disability Insurance for the quarter Size Range: 0-9999999999.99 |
| PITWhAmt | Number | Personal Income Tax (PIT) withheld for the quarter Size Range: 0-9999999999.99 |
| TotalTaxLiability | Number | Total tax liability for the quarter Size Range: 0-9999999999.99 |
| TotalDeposits | Number | Total contributions and withholdings paid for the quarter Size Range: 0-9999999999.99 |
| TotalTaxDue | Number | Total due subject for the quarter Size Range: 0-9999999999.99 |
| NumOfEmployees | Number | Total number of employees for the quarter Size Range: ..9999999 |
| Month1TotEmployees | Number | Total number of employees reported for month 1 of the quarter. Size Range: ..9999999 |
| Month2TotEmployees | Number | Total number of employees reported for month 2 of the quarter. Size Range: ..9999999 |
| Month3TotEmployees | Number | Total number of employees reported for month 3 of the quarter. Size Range: ..9999999 |
| EmployeeDetails | Object[] | Object that contains infromation of the employees for the business |
| EmpSequenceId | String | A unique reference ID for the submission that can be used to identify a particular employee. The Sequence ID will be returned in the Response for your reference. |
| EmployeeId | Guid | A unique identifier generated by TaxBandits for a employee. You can use this ID for your future reference to Update. |
| SSN | String | Enter the nine-digit SSN of the employee. Size Range: 9-11 digits |
| FirstNm | String | First Name of the employee Size Range: ..20 |
| MiddleNm | String | Middle Name of the employee Size Range: ..20 |
| LastNm | String | Last Name of the employee Size Range: ..20 |
| Suffix | String | Suffix of the IndividualAllowed values"Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII" |
| WageCode | String | Wage plan code for the employeeAllowed values"S", "U", "J", "L", "R", "A", "P" |
| TotalWagesAmt | Number | Total subject wages paid for the employee. Size Range: 0-9999999999.99 |
| PITWagesAmt | Number | Personal Income Tax (PIT) wages paid for the employee Size Range: 0-9999999999.99 |
| PITWhAmt | Number | Personal Income Tax (PIT) withheld for the employee Size Range: 0-9999999999.99 |
Request Params
"StateFilings/CAWHUI/Get?RecordId=01999580-9061-77d5-86be-bc5686a6a5a5&SubmissionId=0199c8cc-6d8a-77a7-b401-aed04901d431"
Response JSON
- 200
- 400
- 401
Success Response - This is a sample response for successful API requests.
{
"StatusCode": "200",
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "019c65fa-9213-75c9-bc93-224d4e5ccdb2",
"StateWhUIRecords": [
{
"SequenceId": "001",
"RecordId": "019c65fa-9f59-7644-b238-3e57b4d970e7",
"ReturnHeader": {
"Qtr": "Q3",
"TaxYr": "2025",
"Business": {
"BusinessId": "34a5310b-7471-484a-a3a5-fbef97ac59d6",
"BusinessNm": "Snowdaze LLC",
"PayerRef": null,
"FirstNm": null,
"MiddleNm": null,
"LastNm": null,
"Suffix": null,
"TradeNm": "Snowdaze",
"IsEIN": true,
"EINorSSN": "25-1674903",
"Email": "sample@boodem.com",
"ContactNm": "John",
"Phone": "(789) 456-1231",
"PhoneExtn": "12345",
"Fax": "(712) 354-7895",
"BusinessType": "ESTE",
"SigningAuthority": {
"Name": "John",
"Phone": "(789) 789-7987",
"BusinessMemberType": "ADMINISTRATOR"
},
"KindOfEmployer": null,
"KindOfPayer": null,
"IsBusinessTerminated": false,
"IsForeign": false,
"USAddress": {
"Address1": "12 Main st",
"Address2": "CC avenue",
"City": "Rock Hill",
"State": "SC",
"ZipCd": "29730"
},
"ForeignAddress": null,
"ACADetails": null
}
},
"ReturnData": {
"FormDE9": {
"AccNum": "85412574",
"BranchCd": "684",
"UIRate": "8",
"ETTRate": "4",
"SDIRate": "3",
"TaxableWages": 50000,
"GrandTotWagesAmt": 50000,
"GrandPITWagesAmt": 45000,
"PITWhAmt": 5000,
"GrandPITWhAmt": 5000,
"TotUIContribAmt": 2000,
"TotETTContribAmt": 1000,
"TotSDIContribAmt": 600,
"UITaxableWagesAmt": 25000,
"SDITaxableWagesAmt": 20000,
"TotalTaxLiability": 8600,
"TotalTaxDue": 2600,
"TotalDeposits": 6000,
"TotBalanceDueAmt": 2600,
"TotOverpaymentAmt": 0,
"IsNoPayroll": false,
"IsNoWageReported": false,
"IsNoEmpOrBusinessClosed": false,
"BusinessClosedDt": "02/02/2025",
"NumOfEmployees": {
"Month1TotEmp": 50,
"Month2TotEmp": 124,
"Month3TotEmp": 46
},
"EmployeeDetails": [
{
"SSN": "321522023",
"EmpRef": null,
"LastNm": "roger",
"Suffix": "Sr",
"FirstNm": "kelly",
"MiddleNm": "A",
"PITWhAmt": "3000.00",
"WageCode": "S",
"USAddress": {
"City": "",
"ZipCode": "",
"Address1": "",
"Address2": "",
"StateCode": ""
},
"EmployeeId": "777b3a0c-6fc5-4b4a-b2c2-0e5c072b66e1",
"PITWagesAmt": "25000.00",
"RecipientId": 7469732,
"TotWagesAmt": "30000.00",
"EmpSequenceId": "1",
"OutOfStateWagesAmt": "0.00",
"RecipientAddressId": 4040205
},
{
"SSN": "561251213",
"EmpRef": null,
"LastNm": "samuel",
"Suffix": "Sr",
"FirstNm": "jason",
"MiddleNm": "A",
"PITWhAmt": "2000.00",
"WageCode": "S",
"USAddress": {
"City": "",
"ZipCode": "",
"Address1": "",
"Address2": "",
"StateCode": ""
},
"EmployeeId": "38e39974-f804-4fab-af94-544fe2925556",
"PITWagesAmt": "20000.00",
"RecipientId": 7469733,
"TotWagesAmt": "20000.00",
"EmpSequenceId": "2",
"OutOfStateWagesAmt": "0.00",
"RecipientAddressId": 4040206
}
]
}
}
}
],
"Errors": null
}}
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,
"StateWHRecords": null,
"Errors": [
{
"Id": "S00-000098",
"Name": "SubmissionId",
"Message": "SubmissionId is invalid."
}
]
}
Unauthorized Response - You'll get the below response when your API requests don't contain valid authentication credentials.
{
"StatusCode": 401,
"StatusName": "Unauthorized",
"StatusMessage": "Invalid authorization credentials",
"Errors": [
{
"Id": "AUTH-100018",
"Name": "Authorization",
"Message": "JWT EXPIRED"
}
]
}