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
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier created by TaxBandits for each submission. |
| RecordId | Guid | A unique identifier generated by TaxBandits when a FormWTH10001 return is created. |
Response Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | String | Unique identifier for the submission. |
| StateWHRecords | Object[] | Object to identify the records. |
| SequenceId | String | A unique identifier for this record. |
| ReturnHeader | Object | Contains business information. |
| TaxYear | String | The tax year for which the Form WTH10001 is to be filed. |
| Qtr | String | The quarter for which the Form WTH10001 is to be filed. |
| Business | object | Object to identify the Business Details. |
| BusinessId | Guid | The unique Business ID (Generated by TaxBandits) that you received in the response of the Business CREATE Endpoint. |
| PayerRef | string | The unique identifier for the payer. |
| 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 | Required when TINType is SSN. Provide individual name fields instead of BusinessNm. |
| 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. Required when TINType is EIN. |
| 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. |
| 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[] | Identifies the Form WTH10001 data. |
| FormWTH10001 | Object | Oklahoma withholding tax returns. |
| WHIdNum | String | Oklahoma withholding file number. |
| IsFinalReturn | Boolean | When true, identifies that the payer has closed the withholding account. |
| OperationCeasedDt | String | Withholding account closed date. |
| IsChangeOfAddr | Boolean | When true, identifies that the payer has changed the address. |
| NumOfEmp | Number | Number of employees. |
| TotWages | Number | Total Wages paid this quarter. |
| TotTaxWH | Number | Quarterly Oklahoma income tax withheld from all sources. |
| Interest | Number | Total interest due amount. |
| Penalty | Number | Total penalty amount. |
| BalanceDue | Number | Total due amount. |
| 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/ok10001wh/get?SubmissionId=01a0e79d-5c94-7088-9bfb-261b2a115ac1&RecordId=01a0e79d-5dd7-708a-81af-60fff599f503"
Response JSON
- 200
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
}