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 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 FormWTH10001 return is created. |
Response Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier created by TaxBandits for each submission. Not required when you are creating a return. |
| StateWHRecords | Object[] | Object to create Form WH-10001 |
| 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 WH-10001 |
| Qtr | String | The quarter for which Form WH-10001 needs to be filed.Allowed values"Q1", "Q2", "Q3", "Q4" |
| TaxYr | String | The tax year for which Form WH-10001 needs to be filed.Allowed values"2025", "2026" |
| 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 to the payer in the API. Size Range: ..50 |
| TradeNm | String | Optional Name under which the business operates. Size Range: ..75 |
| IsEIN | Boolean | When true, it identifies the business with an EIN. |
| EINorSSN | String | When IsEIN is true, use Employer Identification Number (EIN). Size Range: 9-11 |
| String | Email address of the business. Size Range: ..100 | |
| IsForeign | Boolean | When true, it 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", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP" |
| 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", "AU", "AJ", "BF", "BA", "FQ", "BG", "BB", "BO", "BE", "BH", "BN", "BD", "BT", "BL", "BK", "BC", "BV", "BR", "IO", "VI", "BX", "BU", "UV", "BM", "BY", "CB", "CM", "CA", "CV", "CJ", "CT", "CD", "CI", "CH", "KT", "IP", "CK", "CO", "CN", "CF", "CG", "CW", "CR", "CS", "IV", "HR", "CU", "UC", "CY", "EZ", "DA", "DX", "DJ", "DO", "DR", "TT", "EC", "EG", "ES", "EK", "ER", "EN", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "FP", "FS", "GB", "GA", "GG", "GM", "GH", "GI", "GR", "GL", "GJ", "GQ", "GT", "GK", "GV", "PU", "GY", "HA", "HM", "VT", "HO", "HK", "HQ", "HU", "IC", "IN", "ID", "IR", "IZ", "EI", "IS", "IT", "JM", "JN", "JA", "DQ", "JE", "JQ", "JO", "KZ", "KE", "KQ", "KR", "KN", "KS", "KV", "KU", "KG", "LA", "LG", "LE", "LT", "LI", "LY", "LS", "LH", "LU", "MC", "MK", "MA", "MI", "MY", "MV", "ML", "MT", "IM", "RM", "MR", "MP", "MX", "MQ", "MD", "MN", "MG", "MJ", "MH", "MO", "MZ", "WA", "NR", "BQ", "NP", "NL", "NC", "NZ", "NU", "NG", "NI", "NE", "NF", "CQ", "NO", "MU", "OC", "PK", "PS", "LQ", "PM", "PP", "PF", "PA", "PE", "RP", "PC", "PL", "PO", "RQ", "QA", "RO", "RS", "RW", "TB", "RN", "WS", "SM", "TP", "SA", "SG", "RI", "SE", "SL", "SN", "NN", "LO", "SI", "BP", "SO", "SF", "SX", "OD", "SP", "PG", "CE", "SH", "SC", "ST", "SB", "VC", "SU", "NS", "SV", "WZ", "SW", "SZ", "SY", "TW", "TI", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TX", "TK", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI" |
| PostalCd | String | Employer/Payer’s postal code. Size Range: ..16 |
| ReturnData | Object | Identifies the Form WH-10001 |
| WTH10001 | Object | Oklahoma withholding tax returns. |
| WHIdNum | String | Oklahoma withholding file number. Size Range: ..9 |
| IsFinalReturn | Boolean | When true, identifies that the payer has closed the withholding account. |
| DateOperationCeased | String | Withholding account closed date. Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY (Example: 01/25/2025). |
| IsChangeOfAdd | Boolean | When true, identifies that the payer has changed the address. |
| EmpCount | Number | Number of employees. Size Range: 0-9999999 |
| L1WagesPaid | Number | Total Wages paid this quarter Size Range: 0-99999999.99 |
| L2WHAmt | Number | Quarterly Oklahoma income tax withheld from all sources. Size Range: 0-99999999.99 |
| L3Interest | Number | Total interest due amount, if applicable. Size Range: 0-99999999.99 |
| L4Penalty | Number | Total penalty amount, if applicable. Size Range: 0-99999999.99 |
| L5TotAmt | Number | Total due amount Size Range: 0-99999999.99 |
| Errors | object[] | Shows detailed error information |
| Id | string | Total due amount Size Range: 0-99999999.99 |
| Name | string | Name of the validation error |
| Message | string | Description of the validation error |
Request Params
"statefilings/OK10001WH/Get?RecordId=f5c0b155-7261-4f9d-b0bc-cad7a0f69d2e&SubmissionId=01993c45-e77e-7383-823a-d13273fd717c"
Response JSON
- 200
- 400
Success Response - This is a sample response for successful API requests.
{
"StatusCode": "200",
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "019d1a68-e397-754b-ab1c-4c2edc8876ec",
"StateWHRecords": [
{
"Sequence": "001",
"RecordId": "019d1a68-fa42-753f-8b18-5d3b60fa6d1f",
"ReturnHeader": {
"Qtr": "Q1",
"TaxYr": "2025",
"Business": {
"BusinessId": "2fa5381e-8c36-4fbd-8d66-8b0db29d3d90",
"BusinessNm": "Snowdaze LLC",
"PayerRef": null,
"FirstNm": null,
"MiddleNm": null,
"LastNm": null,
"Suffix": null,
"TradeNm": "",
"IsEIN": true,
"EINorSSN": "24-4598859",
"Email": "james@sample.com",
"ContactNm": null,
"Phone": "(787) 641-7809",
"PhoneExtn": "12345",
"Fax": "",
"BusinessType": "SCORP",
"SigningAuthority": {
"Name": "Joel Cruz",
"Phone": "(787) 641-7809",
"BusinessMemberType": "TAXOFFICER"
},
"KindOfEmployer": "",
"KindOfPayer": "",
"IsBusinessTerminated": false,
"IsForeign": false,
"USAddress": {
"Address1": "16 Main Street",
"Address2": "Moon lan avenue",
"City": "Arecibo",
"State": "PR",
"ZipCd": "00614"
},
"ForeignAddress": null,
"ACADetails": null
}
},
"ReturnData": {
"FormWTH10001": {
"WHIdNum": "WTH-12345678-12",
"IsFinalReturn": false,
"DateOperationCeased": null,
"IsChangeOfAddr": false,
"EmpCount": "2",
"L1WagesPaid": "2000.00",
"L2WHAmt": "1000.00",
"L3Interest": "20.00",
"L4Penalty": "10.00",
"L5TotAmt": "1030.00"
}
}
}
],
"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,
"StateUIRecords": null,
"Errors": [
{
"Id": "S00-000099",
"Name": "RecordId",
"Message": "RecordId is invalid."
}
]
}