Skip to main content
Version: 2.0.0

Get

Get

Use this endpoint to retrieve the information of a previously created California DE 9 / DE 9C return for the corresponding employer (payer). Your request JSON must include the corresponding SubmissionId and the RecordId (optional) for the forms.

POST StateFilings/CAWHUI/Get 

Request Body

FieldTypeDescription
SubmissionIdGuidUnique identifier created by TaxBandits for each submission.
RecordIdGuidA 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

FieldTypeDescription
SubmissionIdGuidUnique identifier created by TaxBandits for each submission.
StateWHRecordsObject[]Object to identify the records.
SequenceIdStringA unique identifier for this record.
RecordIdGuidA unique identifier generated by TaxBandits when a DE 9/9C return is created.
ReturnHeaderObjectContains business information.
TaxYearStringThe tax year for which the Form DE 9/9C is to be filed.
QtrStringThe quarter for which the Form DE 9/9C is to be filed.
BusinessobjectObject to identify the Business Details.
BusinessIdGuidThe unique Business ID (Generated by TaxBandits) that you received in the response of the Business CREATE Endpoint.
PayerRefstringYour unique identifier for the payer.
IsDefaultBusinessBooleanWhen set to TRUE, this business will be set as the default across requests that do not specify a business.
TINDetailsobjectTIN information for the business.
FormatstringSpecifies how the TIN is passed.
TINTypestringSpecify the TIN type of the business.
TINstringThe TIN value according to the Format selected.
BusinessNmstringLegal name of the business. Required when TINType is EIN.
NameCtrlstringName control of the business as registered with the IRS.
DBADetailsobject[]DBA (Doing Business As) information.
DBANmstringName of the DBA.
DBARefstringUnique identifier for the DBA.
DBAIdGuidTaxBandits-generated DBA identifier.
Addressobject[]Address information of the DBA.
Address1stringStreet address or PO Box.
Address2stringOptional Suite or apartment number.
CitystringDBA's city.
ProvinceOrStatestringDBA's province or state name.
ZipcdstringDBA's ZIP code.
CountrystringDBA's 2-character country code.
EmailstringEmail address of the business.
AddressobjectPrimary address of the business.
Address1stringStreet address or PO Box of the business.
Address2stringSuite or apartment number of the business.
CitystringCity of the business.
ProvinceOrStatestringProvince or state name of the business.
ZipCdstringZIP code of the business.
Countrystring2-character country code of the business.
ContactDetailsobject[]Details of the person the IRS can contact regarding the given business.
FirstNmstringFirst name of the contact person.
MiddleNmstringMiddle name of the contact person.
LastNmstringLast name of the contact person.
SuffixstringThe suffix of the contact person.
PhonestringPhone number of the contact person.
PhoneExtnstringPhone extension number.
EmailstringEmail address of the contact person.
FaxstringFax number of the contact person.
SigningAuthorityObjectDetails of the person authorized to sign the return.
FirstNmStringFirst name of the signatory.
MiddleNmStringMiddle name of the signatory.
LastNmStringLast name of the signatory.
SuffixStringThe suffix of the signatory.
PhoneStringPhone number of the signatory.
PhoneExtnStringPhone extension number of the signatory.
BusinessMemberTypeStringTitle or role of the signatory.
ReturnDataObject[]Identifies the Form DE 9/9C data.
FormDE9ObjectCalifornia withholding/UI tax return.
AccNumStringCalifornia withholding account number.
BranchCdStringBranch Code to identify a specific business location or branch under the given account number.
IsNoWageRptdBooleanIf true, identifies that no wages have been paid for the quarter.
IsFinalReturnBooleanIf true, identifies that the business has ceased operations or had no employees during that quarter.
OperationCeasedDtStringDate on which the business ceased operations or had no employees during that quarter.
TotGrossWagesNumberTotal subject wages paid for the quarter.
UITaxRateNumberUnemployment Insurance (UI) rate.
TotTaxableWagesNumberUnemployment Insurance (UI) wages for the quarter.
UITaxDueNumberEmployer's contributions on Unemployment Insurance for the quarter.
ETTTaxDueNumberEmployer's contributions on Employment Training Tax for the quarter.
SDITaxableWagesNumberState Disability Insurance (SDI) wages for the quarter.
SDITaxDueNumberEmployer's contributions to State Disability Insurance for the quarter.
PITWHNumberPersonal Income Tax (PIT) withheld for the quarter.
TotTaxDueNumberTotal tax liability for the quarter.
TotTaxPaidNumberTotal contributions and withholdings paid for the quarter.
BalanceDueNumberTotal amount due for the quarter.
NumOfEmpObjectIdentifies the total number of employees for the quarter.
TotMonth1EmpNumberTotal number of employees reported for month 1 of the quarter.
TotMonth2EmpNumberTotal number of employees reported for month 2 of the quarter.
TotMonth3EmpNumberTotal number of employees reported for month 3 of the quarter.
EmpDetailsObject[]Object that contains the information of the employees for the business.
EmployeeSequenceIdStringA unique reference ID for the submission that can be used to identify a particular employee.
EmployeeIdGuidA unique identifier generated by TaxBandits for an employee.
EmployeeRefStringYour unique identifier for the Employee.
SSNStringSSN of the employee.
FirstNmStringFirst name of the employee.
MiddleNmStringMiddle name of the employee.
LastNmStringLast name of the employee.
SuffixStringSuffix of the individual.
WageCodeStringWage plan code for the employee.
TotalWagesNumberTotal subject wages paid for the employee.
PITWagesNumberPersonal Income Tax (PIT) wages paid for the employee.
PITTaxWHNumberPersonal Income Tax (PIT) withheld for the employee.
Errorsobject[]Shows detailed error information.
IdstringReturns the validation error ID.
NamestringName of the validation error.
MessagestringDescription of the validation error.

Request JSON​

"statefilings/cawhui/Get?SubmissionId=01a0e6d4-4d61-77f5-bb55-1eb1d880a1af&RecordId=01a0e6d4-5053-70d8-8bfb-e6b74e1c9d99"

Response JSON​

Success Response - This is a sample response for successful API requests.

{
"SubmissionId": "01a0e6d4-4d61-77f5-bb55-1eb1d880a1af",
"StateWHRecords": [
{
"SequenceId": "01",
"RecordId": "01a0e6d4-5053-70d8-8bfb-e6b74e1c9d99",
"ReturnHeader": {
"Qtr": "Q3",
"TaxYear": "2026",
"Business": {
"BusinessId": "10849a59-dc25-4717-bb1e-c2e9b0135646",
"PayerRef": null,
"IsDefaultBusiness": true,
"TINDetails": {
"Format": "PLAIN_TIN",
"TINType": "EIN",
"TIN": "48-7789830"
},
"BusinessNm": "Snowdaze LLC",
"DBADetails": {
"DBANm": "Iceberg Icecreams",
"DBARef": "DBA1001",
"DBAId": "226711b9-c8b9-45f6-8834-07bb7e8dcb8c",
"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": {
"FormDE9": {
"AccNum": "12352114",
"BranchCd": "566",
"IsNoWageRptd": false,
"IsFinalReturn": true,
"OperationCeasedDt": "02/02/2026",
"TotGrossWages": 50000,
"UITaxRate": "1",
"TotTaxableWages": 25000,
"UITaxDue": 250,
"ETTTaxDue": 25,
"SDITaxableWages": 20000,
"SDITaxDue": 260,
"PITWH": 5000,
"TotTaxDue": 5535,
"TotTaxPaid": 1000,
"BalanceDue": 4535,
"NumOfEmp": {
"TotMonth1Emp": 2,
"TotMonth2Emp": 0,
"TotMonth3Emp": 0
},
"EmpDetails": [
{
"EmployeeSequenceId": "1",
"EmployeeId": "e0aa23de-b3f3-4fbf-b1a4-7fafe1e6237b",
"EmployeeRef": null,
"SSN": "332-54-3301",
"FirstNm": "Kelly",
"MiddleNm": "A",
"LastNm": "Roger",
"Suffix": "Sr",
"WageCode": "S",
"TotalWages": 30000,
"PITWages": 25000,
"PITTaxWH": 3000
},
{
"EmployeeSequenceId": "12",
"EmployeeId": "d460d26b-c9d3-45ff-8d3e-615b40aba076",
"EmployeeRef": null,
"SSN": "572-15-4302",
"FirstNm": "Jason",
"MiddleNm": null,
"LastNm": "Samuel",
"Suffix": null,
"WageCode": "S",
"TotalWages": 20000,
"PITWages": 20000,
"PITTaxWH": 2000
}
]
}
}
}
],
"Errors": null
}