Skip to main content
Version: 2.0.0

Update

Update

Use this endpoint to update the information on existing Minnesota Withholding Reports that are already created for a specific employer (payer).

POST StateFilings/MNWH/Update
Run in Postman

Request Body

FieldTypeDescription
SubmissionIdGuidUnique identifier created by TaxBandits for each submission.
StateWHRecordsObjectObject to identify the records.
SequenceIdStringA unique identifier for this record. Size Range: ..50
RecordIdGuidA unique identifier generated by TaxBandits when a MNWH return is created.
ReturnHeaderObjectContains business information.
TaxYearStringThe tax year for which the Form MNWH is to be filed.
Allowed values

2025,2026

QtrStringThe quarter for which the Form MNWH is to be filed.
Allowed values

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

BusinessobjectObject to identify the Business Details.
BusinessIdGuidOptional Use the unique Business ID (Generated by TaxBandits) that you received in the response of the Business CREATE Endpoint. If you do not have a Business ID, ignore the field. By giving the Business ID, you do not have to provide all the business information again.
PayerRefstringOptional Your unique identifier for the payer. Can replace BusinessId in future requests. Size Range: 50
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.
Allowed values

"PLAIN_TIN" — Pass TIN directly

TINTypestringSpecify the TIN type of the business.
Allowed values

"EIN"

TINstringThe TIN value according to the Format selected.
BusinessNmstringLegal name of the business. Required when TINType is EIN. Size Range: 75
NameCtrlstringName control of the business as registered with the IRS. Size Range: 4
DBADetailsobjectOptional DBA (Doing Business As) information.
DBANmstringName of the DBA. Size Range: 75
DBARefstringUnique identifier for the DBA. Size Range: 1-50
DBAIdGuidTaxBandits-generated DBA identifier.
AddressobjectAddress information of the DBA.
Address1stringStreet address or PO Box. Size Range: 46
Address2stringOptional Suite or apartment number. Size Range: 46
CitystringDBA's city. Size Range: 50
ProvinceOrStatestringDBA's province or state name.
When the country code is US:
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"

 When the country code is CA:
Allowed values

"AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT"

 Note: The *size range is set to 50 for all countries except the United States and Canada.
ZipcdstringDBA's ZIP code. Size Range: 5-16
CountrystringDBA's 2-character country code.
Allowed values

"US","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"

AddressobjectPrimary address of the business.
Address1stringStreet address or PO Box of the business. Size Range: 46
Address2stringOptional Suite or apartment number of the business. Size Range: 46
CitystringCity of the business. Size Range: 50
ProvinceOrStatestringProvince or state name of the business.
When the country code is US:
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"

 When the country code is CA:
Allowed values

"AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT"

 Note: The size range is set to 50 for all countries except the United States and Canada.
ZipCdstringZIP code of the business. Size Range: 5-16
Countrystring2-character country code of the business.
Allowed values

"US","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"

ContactDetailsobjectDetails of the person the IRS can contact regarding the given business.
FirstNmstringFirst name of the contact person. Size Range: 20
MiddleNmstringOptional Middle name of the contact person. Size Range: 20
LastNmstringLast name of the contact person. Size Range: 20
SuffixstringOptional The suffix of the contact person.
Allowed values

"Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"

PhonestringOptional Phone number of the contact person. Size Range: 10 digits
PhoneExtnstringOptional Phone extension number. Size Range: 5
EmailstringOptional Email address of the contact person. Size Range: ..100
FaxstringOptional Fax number of the contact person. Size Range: 10 digits
BusinessTypeStringLegal structure of the business.
Allowed values

"ESTE", "PART", "CORP", "EORG", "SPRO", "SLGOV"

SigningAuthorityObjectDetails of the person authorized to sign the return. Mandatory for 94x forms.
FirstNmStringFirst name of the signatory. Size Range: 20
MiddleNmStringOptional Middle name of the signatory. Size Range: 20
LastNmStringLast name of the signatory. Size Range: 20
SuffixStringOptional The suffix of the signatory.
Allowed values

"Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"

PhoneStringOptional Phone number of the signatory Size Range: 10
PhoneExtnStringOptional Phone extension number of the signatory. Size Range: 5
BusinessMemberTypeStringOptional Title or role of the signatory.
Allowed values

"CORPORATESECRETARY", "SECRETARYTREASURER", "PARTNER", "GENERALPARTNER", "LIMITEDPARTNER", "LLCMEMBER", "MANAGINGMEMBER", "MANAGER", "TAXMATTERPARTNER", "PRESIDENT", "VICEPRESIDENT", "CORPORATETREASURER", "TREASURER", "ASSISTANTTREASURER", "CHIEFACCOUNTINGOFFICER", "CHIEFEXECUTIVEOFFICER", "CHIEFFINANCIALOFFICER", "TAXOFFICER", "CHIEFOPERATINGOFFICER", "CORPORATEOFFICER", "EXECUTIVEDIRECTOR", "DIRECTOR", "CHAIRMAN", "EXECUTIVEADMINISTRATOR", "RECEIVER", "PASTOR", "ASSISTANTTORELIGIOUSLEADER", "REVEREND", "PRIEST", "MINISTER", "RABBI", "LEADEROFRELIGIOUSORGANIZATION", "SECRETARY", "DIRECTOROFTAXATION", "DIRECTOROFPERSONNEL", "ADMINISTRATOR", "EXECUTOR", "TRUSTEE", "FIDUCIARY", "OWNER", "SOLEPROPRIETOR", "MEMBER", "SOLEMEMBER", "REPORTINGAGENT"

ReturnDataObjectContains the return information.
MNWHReportObjectIdentifies the Form MNWHdata.
FilingFrequencystringFiling frequency of the Form MNWHReport
Allowed values

"QUARTERLY ", "ANNUAL"

WHIdNumberStringMinnesota withholding file number.Sample Format: XXXXXXX Size Range: 7
IsNoWageRptdbooleanWhen true, indicates that no wage is reported in this quarter.
NumberOfEmployeesNumberIdentifies the total number of employees for the quarter. Size Range: 0-9999999
TotalTaxWithheldNumberTotal tax withheld from all sources for the filing period Size Range: 0-999999999999.99
TotalGrossWagesNumberTotal Gross Wages for the filing period Size Range:0-999999999999.99
TotalTaxPaidNumberTotal tax paid for the filing period Size Range:0-999999999999.99
TotalWithheldDueNumberTotal tax Withheld due. Size Range: 0-999999999999.99
OverPaymentRecoveryTypestringGets the overpayment recovery type. Whether to have the state refund the excess amount or apply it to next return.
Allowed values

"REFUND", "CREDIT"

WithheldTaxliabilityObject[]Contains the withholding tax liability details for the filing period, including the liability date and corresponding amount.
DateStringSpecifies the date on which the withholding tax liability was incurred. Expected format: MM/DD/YYYY.
AmountNumberSpecifies the withholding tax liability amount for the corresponding date. Size Range: 0-999999999999.99

Response Body

FieldTypeDescription
SubmissionIdGuidUnique identifier for a submission.
SuccessRecordsObject[]Provides detailed information about the success status of Form MNWH records.
SequenceIdstringA unique reference ID for the submission that can be used to identify a particular record. The Sequence ID will be returned in the response for your reference.
BusinessIdGuidUnique identifier for the business (payer) generated by TaxBandits.
PayerRefstringUnique identifier for the business (payer) provided by you.
RecordIdGuidA unique identifier generated by TaxBandits when a Form MNWH return is created.
FormTypestringReturns the type of UI form.
StatusstringReturns the record status.
StatusTsstringReturns the date and time when the return was created.
InfostringProvides additional information about the return.
ErrorsObject[]Displays error information related to the state returns of Form MNWH.
IdstringReturns the validation error ID.

Request JSON​

{
  "SubmissionId": "01a00e55-9e5e-74e6-b8c1-4ebd32dec9f1",
  "StateWHRecords": [
      {
          "SequenceId": "001",
          "RecordId": "01a00e55-9faf-769d-95b5-9ac30096bdf4",
          "ReturnHeader": {
              "Qtr": null,
              "Month": null,
              "TaxYear": "2026",
              "Business": {
                  "BusinessId": "72d4ff2a-e7e6-47b3-9c85-82b7ee40fa4c",
                  "PayerRef": null,
                  "IsDefaultBusiness": true,
                  "TINDetails": {
                      "Format": "PLAIN_TIN",
                      "TINType": "EIN",
                      "TIN": "45-2270516"
                  },
                  "IndividualNm": null,
                  "BusinessNm": "Snowdaze LLC",
                  "NameCtrl": "FIRE",
                  "DBADetails": {
                      "DBANm": "Iceberg Icecreams",
                      "DBARef": "DBA1001",
                      "DBAId": "28E59D48-C587-4B70-9B63-9A172522C994",
                      "Address": {
                          "Address1": "123 Main St",
                          "Address2": "Suite 1001",
                          "City": "Rock Hill",
                          "ProvinceOrState": "MN",
                          "ZipCd": "55001",
                          "Country": "US"
                      }
                  },
                  "Address": {
                      "Address1": "123 Main St",
                      "Address2": "Suite 1001",
                      "City": "Rock Hill",
                      "ProvinceOrState": "MN",
                      "ZipCd": "55001",
                      "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": {
              "MNWHReport": {
                  "FilingFrequency": "ANNUAL",
                  "WHIdNumber": "5824512",
                  "IsNoWageReported": false,
                  "NumberOfEmployees": 153,
                  "TotalGrossWages": 2000,
                  "TotalTaxWithheld": 2000,
                  "TotalTaxPaid": 2000,
                  "TotalWithheldDue": 0,
                  "OverPaymentRecoveryType": null,
                  "WithheldTaxLiability": [
                      {
                          "Date": "03/21/2025",
                          "Amount": "2000.00"
                      }
                  ]
              }
          }
      }
  ]
}

Response JSON​

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

{
  "SubmissionId": "01a00e55-9e5e-74e6-b8c1-4ebd32dec9f1",
  "SuccessRecords": [
      {
          "SequenceId": "001",
          "BusinessId": "72d4ff2a-e7e6-47b3-9c85-82b7ee40fa4c",
          "PayerRef": null,
          "RecordId": "01a00e55-9faf-769d-95b5-9ac30096bdf4",
          "FormType": "MNQWTH",
          "Status": "CREATED",
          "StatusTs": "2026-08-17 02:30:39 -04:00",
          "Info": null,
          "Errors": null
      }
  ],
  "ErrorRecords": null,
  "Errors": null
}