Skip to main content
Version: 2.0.0

Get

Get

Use this endpoint to retrieve the information of a previously created WTH10001 form for the corresponding employer (payer). Your request JSON must include the corresponding SubmissionId and the RecordId (optional) for the forms.

GET StateFilings/OK10001WH/Get 

Request Body

FieldTypeDescription
SubmissionIdGuidUnique identifier created by TaxBandits for each submission.
RecordIdGuidA unique identifier generated by TaxBandits when a FormWTH10001 return is created.

Response Body

FieldTypeDescription
SubmissionIdStringUnique identifier for the submission.
StateWHRecordsObject[]Object to identify the records.
SequenceIdStringA unique identifier for this record.
ReturnHeaderObjectContains business information.
TaxYearStringThe tax year for which the Form WTH10001 is to be filed.
QtrStringThe quarter for which the Form WTH10001 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.
PayerRefstringThe 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.
IndividualNmobjectRequired when TINType is SSN. Provide individual name fields instead of BusinessNm.
FirstNmstringThe first name of the individual.
MiddleNmstringMiddle name of the individual.
LastNmstringThe last name of the individual.
SuffixstringSuffix of the individual's name.
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.
Address2stringSuite 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 WTH10001 data.
FormWTH10001ObjectOklahoma withholding tax returns.
WHIdNumStringOklahoma withholding file number.
IsFinalReturnBooleanWhen true, identifies that the payer has closed the withholding account.
OperationCeasedDtStringWithholding account closed date.
IsChangeOfAddrBooleanWhen true, identifies that the payer has changed the address.
NumOfEmpNumberNumber of employees.
TotWagesNumberTotal Wages paid this quarter.
TotTaxWHNumberQuarterly Oklahoma income tax withheld from all sources.
InterestNumberTotal interest due amount.
PenaltyNumberTotal penalty amount.
BalanceDueNumberTotal due amount.
Errorsobject[]Shows detailed error information.
IdstringReturns the validation error ID.
NamestringName of the validation error.
MessagestringDescription of the validation error.

Request JSON​

"statefilings/ok10001wh/get?SubmissionId=01a0e79d-5c94-7088-9bfb-261b2a115ac1&RecordId=01a0e79d-5dd7-708a-81af-60fff599f503"

Response JSON​

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

{
"SubmissionId": "01a0e79d-5c94-7088-9bfb-261b2a115ac1",
"StateWHRecords": [
{
"SequenceId": "001",
"RecordId": "01a0e79d-5dd7-708a-81af-60fff599f503",
"ReturnHeader": {
"Qtr": "Q3",
"TaxYear": "2026",
"Business": {
"BusinessId": "cd985bc6-3c6b-4532-a757-aedda88848c3",
"PayerRef": null,
"IsDefaultBusiness": true,
"TINDetails": {
"Format": "PLAIN_TIN",
"TINType": "EIN",
"TIN": "80-2684376"
},
"BusinessNm": "Albert Corp",
"DBADetails": {
"DBANm": "Iceberg Icecreams",
"DBARef": "DBA1001",
"DBAId": "3E769EAD-B1C5-4C29-B14E-EA84130F748D",
"Address": {
"Address1": "123 Main St",
"Address2": "Suite 1001",
"City": "Rock Hill",
"ProvinceOrState": "SC",
"ZipCd": "29730",
"Country": "US"
}
},
"Address": {
"Address1": "789 Business Rd",
"Address2": "Suite 300",
"City": "Toronto",
"ProvinceOrState": "ONTARIO",
"ZipCd": "M5V 2T2",
"Country": "CA"
},
"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": {
"FormWTH10001": {
"WHIdNum": "WTH-12345678-90",
"IsFinalReturn": true,
"OperationCeasedDt": "08/01/2026",
"IsChangeOfAddr": true,
"NumOfEmp": 25,
"TotWages": 1000,
"TotTaxWH": 500,
"Interest": 160,
"Penalty": 160,
"BalanceDue": 820
}
}
}
],
"Errors": null
}