Skip to main content
Version: 1.7.3

Update

Update

Use this endpoint to update the information on existing WTH10001 forms that are already created for a specific payer.

Note:

You cannot update a return once it has been transmitted.

PUTStateFilings/OK10001WH/Update
Run in Postman

Request Body

FieldTypeDescription
StateWHRecordsObject[]Object to create Form WH-10001
SubmissionIdGuidUnique identifier created by TaxBandits for each submission. Not required when you are creating a return.
SequenceIdStringA unique number given by an inbound application to identify failed records.
Size Range: ..10
ReturnHeaderObjectIdentifies the supporting details of Form WH-10001
QtrStringThe quarter for which Form WH-10001 needs to be filed.
Allowed values

"Q1", "Q2", "Q3", "Q4"

TaxYrStringThe tax year for which Form WH-10001 needs to be filed.
Allowed values

"2025", "2026"

BusinessObjectThe details of the business you’re filing for.
BusinessNmStringName of the business.
Size Range: ..75
PayerRefstringOptional 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
TradeNmStringOptional Name under which the business operates.
Size Range: ..75
IsEINBooleanWhen true, it identifies the business with an EIN.
EINorSSNStringWhen IsEIN is true, use Employer Identification Number (EIN).
Size Range: 9-11
EmailStringEmail address of the business.
Size Range: ..100
IsForeignBooleanWhen true, it identifies the business as having a foreign address.
USAddressObjectIf IsForeign is false, pass the US address of the business.
Address1StringEmployer/Payer’s US address (street address or post office box).
Size Range: ..46
Address2StringOptional Employer/Payer’s suite or apartment.
Size Range: ..46
CityStringEmployer/Payer’s city.
Size Range: ..50
StateStringEmployer/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"

ZipCdStringEmployer/Payer’s zip code.
Size Range: 5..10
ForeignAddressObjectIf IsForeign is true, pass the foreign address of the business.
Address1StringEmployer/Payer’s foreign address (street address or post office box).
Size Range: ..50
Address2StringOptional Employer/Payer’s suite or apartment.
Size Range: ..50
CityStringEmployer/Payer’s city.
Size Range: ..50
ProvinceOrStateNmStringEmployer/Payer’s province or state name.
Size Range: ..50
CountryStringEmployer/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"

PostalCdStringEmployer/Payer’s postal code.
Size Range: ..16
ReturnDataObjectIdentifies the Form WH-10001
WTH10001ObjectOklahoma withholding tax returns.
WHIdNumStringOklahoma withholding file number.
Size Range: ..9
IsFinalReturnBooleanWhen true, identifies that the payer has closed the withholding account.
DateOperationCeasedStringWithholding account closed date. Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY (Example: 01/25/2025).
IsChangeOfAddBooleanWhen true, identifies that the payer has changed the address.
EmpCountNumberNumber of employees.
Size Range: 0-9999999
L1WagesPaidNumberTotal Wages paid this quarter
Size Range: 0-99999999.99
L2WHAmtNumberQuarterly Oklahoma income tax withheld from all sources.
Size Range: 0-99999999.99
L3InterestNumberTotal interest due amount, if applicable.
Size Range: 0-99999999.99
L4PenaltyNumberTotal penalty amount, if applicable.
Size Range: 0-99999999.99
L5TotAmtNumberTotal due amount
Size Range: 0-99999999.99

Response Body

FieldTypeDescription
SubmissionIdGuidUnique identifier of a submission
SuccessRecordsobject[]It will show the detailed information about the success status of Form WH-10001 Records
SequenceIdstringA unique number given by an inbound application to identify a particular records.
BusinessIdGuidUnique identifier of a Business
PayerRefstringUnique identifier of the payer
RecordIdGuidA unique identifier generated by TaxBandits when a WH-10001 return is created
FormTypestringDenotes the type of withholding form WH-10001.
StatusstringReturns the record status of the return.
StatusTsstringDate and time of the return created.
InfostringReturns the information about the return
Errorsobject[]Shows error information of state returns of Form WH-1001
IdstringReturns the validation error ID.
NamestringName of the validation error.
MessagestringDescription of the validation error.
ErrorRecordsobject[]It will show the detailed information about the error status of Form WH-1001 Records.
SequenceIdstringA unique number given by an inbound application to identify a particular records. The Sequence ID will be returned in the Response for your reference.
RecordIdGuidUnique identifier of a record
Errorsobject[]Shows detailed error information
IdstringReturns the validation error ID
NamestringName of the validation error
MessagestringDescription of the validation error
Errorsobject[]Shows detailed error information.
IdstringReturns the validation error ID.
NamestringName of the validation error.
MessagestringDescription of the validation error.

Request JSON​

{
    "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"
                }
            }
        }
    ]
}

Response JSON​

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",
  "SuccessRecords": [
      {
          "SequenceId": "001",
          "BusinessId": "2fa5381e-8c36-4fbd-8d66-8b0db29d3d90",
          "PayerRef": "bdfjjghghdhgfh",
          "RecordId": "019d1a68-fa42-753f-8b18-5d3b60fa6d1f",
          "FormType": "WTH10001",
          "Status": "CREATED",
          "StatusTs": "2026-03-23 16:51:30 +05:30",
          "Info": null,
          "Errors": null
      }
  ],
  "ErrorRecords": null,
  "Errors": null
}