Skip to main content
Version: 2.0.0

Create

Create

Use this endpoint to create Form MN MDES1 (Minnesota Quarterly Tax and Wage Report) for an employer (payer), reporting quarterly wages, taxable wages, and unemployment insurance (UI) contributions due, along with required employee wage details for the corresponding quarter.

Form MN MDES1 must be filed every quarter, even if no wages were paid.

POST StateFilings/MNUI/Create
Run in Postman

Request Body

FieldTypeDescription
StateUIRecordsObject[]Object to identify the records.
SequenceIdStringA unique identifier for this record. 
Size Range: ..50
ReturnHeaderObjectContains business information.
The tax year for which the Form MDES1 is to be filed.
Allowed values

2025,2026

QtrStringThe quarter for which the Form MDES1 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 providing 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: 3..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
ReturnDataObjectContains the return information.
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
PhoneStringOptional Phone number of the signatory.
Size Range: 10
PhoneExtnStringOptional Phone extension number of the signatory.
Size Range: 5
ReturnDataObjectContains the return information.
FormMDES1ObjectIdentifies the Form MDES1 data.
UIIdNumberStringEmployer's Minnesota Unemployment Account Number.
Size Range: 8 digits
Allowed values

"99999999"

UITaxRateNumberTax rate for the quarter.
Size Range: 0-1
IsNoWageReportedBooleanWhen true, indicates that no wage is reported in this quarter.
NumberOfEmployeesObjectIdentifies the total number of employees for the quarter.
TotalMonth1EmployeestringTotal number of employees in month 1 of the quarter.
Size Range: 0-9999999
TotalMonth2EmployeestringTotal number of employees in month 2 of the quarter.
Size Range: 0-9999999
TotalMonth3EmployeestringTotal number of employees in month 3 of the quarter.
Size Range: 0-9999999
EmployeeDetailsObject[]Object to identify the employee details.
EmployeeSequenceIdstringA unique number to identify this record.
Size Range: ..10
EmployeeIdGuidOptional A unique ID generated by TaxBandits after the return is created and returned in the response.
SSNstringEmployee's Social Security Number (SSN).
Size Range: 9-11
FirstNmstringThe first name of the individual.
Size Range: 20
MiddleNmstringOptional Employee's middle name.
Size Range: 20
LastNmstringEmployee's last name.
Size Range: 20
SuffixstringOptional Employee's suffix.
Allowed values

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

PlantCodestringIdentifies the plant, establishment, or work location associated with the employee's wages.
Size Range: 4 digits
GrossWagesNumberTotal gross wages paid to the employee during the reporting quarter.
Size Range: 0-999999999999.99
TaxableWagesNumberPortion of the employee's wages subject to Minnesota unemployment insurance tax.
Size Range: 0-999999999999.99
ExcessWagesNumberPortion of wages exceeding the applicable unemployment insurance taxable wage base.
Size Range: 0-999999999.99
QuarterTipWagesNumberTotal tips reported by the employee during the quarter that are included in wage reporting.
Size Range: 0-99999999.99
NumberOfHoursWorkedNumberTotal number of hours worked by the employee during the reporting quarter.
Size Range: 2 digits
NumberOfWeeksWorkedNumberTotal number of weeks worked by the employee during the reporting quarter.
Size Range: 2 digits
StateTaxableWagesNumberTotal wages subject to state unemployment insurance taxation for the employee.
Size Range: 0-999999999999.99
TaxWithheldNumberAmount of state tax withheld from the employee's wages, if applicable.
Size Range: 0-999999999999.99
HireDatestringDate on which the employee was hired.
Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY. Example: 01/25/2026 or 01-25-2026
TerminatedDatestringDate on which the employee's employment was terminated, if applicable.
Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY. Example: 01/25/2026 or 01-25-2026
IsMonth1BooleanWhen true, indicates the employee was employed during month 1 of the quarter.
IsMonth2BooleanWhen true, indicates the employee was employed during month 2 of the quarter.
IsMonth3BooleanWhen true, indicates the employee was employed during month 3 of the quarter.
IsOfficerBooleanIndicates whether the employee is an officer of the employer.
TotalGrossWagesNumberTotal gross wages reported for all employees for the quarter.
Size Range: 0-999999999999.99
TotalTaxableWagesNumberTotal taxable wages reported for all employees for the quarter.
Size Range: 0-999999999999.99
TotalExcessWagesNumberTotal excess wages reported for all employees for the quarter.
Size Range: 0-999999999999.99
UITaxDueNumberUnemployment insurance tax due for the reported taxable wages.
Size Range: 0-99999999999.99
AdditionalTaxDueNumberAdditional tax amount due, if applicable.
Size Range: 0-999999999999.99
TotalUITaxDueNumberTotal unemployment insurance tax due for the quarter.
Size Range: 0-999999999999.99
WorkForceEnhancementFeeNumberWorkforce enhancement fee due for the reporting period, if applicable.
Size Range: 0-99999999999.99
TotalQuarterUIDueNumberTotal unemployment insurance amount due for the quarter, including applicable taxes and fees.
Size Range: 0-99999999999.99

Response Body

FieldTypeDescription
SubmissionIdGuidUnique identifier for a submission.
SuccessRecordsobject[]Provides detailed information about the success status of Form MDES1 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 MDES1 return is created.
FormTypestringType of 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 MDES1.
IdstringReturns the validation error ID.
NamestringName of the validation error.
ErrorRecordsobject[]Provides detailed information about the error status of Form MDES1 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.
RecordIdGuidUnique identifier for the record.
Errorsobject[]Displays detailed error information.
IdstringReturns the validation error ID.
NamestringName of the validation error.
MessagestringDescription of the validation error.

Request JSON​

Return with Business as EIN and US address

{
  "StateUIRecords": [
      {
          "SequenceId": "001",
          "ReturnHeader": {
              "TaxYear": "2026",
              "Qtr": "Q1",
              "Business": {
                  "PayerRef": "Snow1234",
                  "BusinessId": null,
                  "IsDefaultBusiness": true,
                  "TINDetails": {
                      "Format": "PLAIN_TIN",
                      "TINType": "EIN",
                      "TIN": "45-9879261"
                  },
                  "BusinessNm": "Snowdaze LLC",
                  "NameCtrl": "SNOW",
                  "DBADetails": {
                      "DBANm": "Iceberg Icecreams",
                      "DBARef": "DBA1001",
                      "DBAId": null,
                      "IsDefaultDBA": true,
                      "Address": {
                          "Address1": "395 CENTRAL AVE W.",
                          "Address2": "Suite 1001",
                          "City": "Saint Paul",
                          "ProvinceOrState": "MN",
                          "ZipCd": "55117",
                          "Country": "US"
                      }
                  },
                  "Address": {
                      "Address1": "395 CENTRAL AVE W.",
                      "Address2": "Suite 1001",
                      "City": "Saint Paul",
                      "ProvinceOrState": "MN",
                      "ZipCd": "55117",
                      "Country": "US"
                  },
                  "BusinessType": "SLGOV",
                  "ContactDetails": {
                      "FirstNm": "James",
                      "MiddleNm": "A",
                      "LastNm": "Anderson",
                      "Suffix": "Jr",
                      "Phone": "8035551234",
                      "PhoneExtn": "101",
                      "Email": "contact@snowdaze.com",
                      "Fax": "8035555678"
                  },
                  "SigningAuthority": {
                      "FirstNm": "Michael",
                      "MiddleNm": "A",
                      "LastNm": "Carter",
                      "Suffix": "Jr",
                      "Phone": "9725550100",
                      "PhoneExtn": "23456",
                      "BusinessMemberType": "ADMINISTRATOR"
                  }
              }
          },
          "ReturnData": {
              "FormMDES1": {
                  "UIIdNumber": "34567822",
                  "UITaxRate": 0.54,
                  "IsNoWageRptd": false,
                  "NumberOfEmployees": {
                      "TotalMonth1Employees": 0,
                      "TotalMonth2Employees": 1,
                      "TotalMonth3Employees": 0
                  },
                  "EmployeeDetails": [
                      {
                          "EmployeeSequenceId": "01",
                          "EmployeeId": null,
                          "SSN": "356377336",
                          "FirstNm": "Annie",
                          "MiddleNm": "Joe",
                          "LastNm": "Smith",
                          "Suffix": "VII",
                          "PlantCode": "4565",
                          "GrossWages": 50000,
                          "TaxableWages": 44000,
                          "ExcessWages": 6000,
                          "QuarterTipWages": 1000,
                          "NumberOfHoursWorked": "99",
                          "NumberOfWeeksWorked": "90",
                          "StateTaxableWages": 20,
                          "TaxWithheld": 1000,
                          "HireDate": "08/20/2026",
                          "TerminatedDate": "08/20/2026",
                          "IsMonth1": false,
                          "IsMonth2": true,
                          "IsMonth3": false,
                          "IsOfficer": true
                      }
                  ],
                  "TotalGrossWages": 50000,
                  "TotalTaxableWages": 44000,
                  "TotalExcessWages": 6000,
                  "UITaxDue": 237.6,
                  "AdditionalTaxDue": 33.26,
                  "TotalUITaxDue": 270,
                  "WorkForceEnhancementFee": 44,
                  "TotalQuarterUIDue": 314
              }
          }
      }
  ]
}

Response JSON​

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

{
"SubmissionId": "019c6f03-7a2d-72f9-870c-0b492254eba2",
"SuccessRecords": [
    {
        "SequenceId": "001",
        "BusinessId": "fc1174c4-4f5a-4fd7-b3a5-7c6d68791333",
        "PayerRef": "PayerRef8399",
        "RecordId": "019c6f03-7e3d-77b8-a575-5a3a3a2689a5",
        "FormType": "MDES1",
        "EmployeeData": [
            {
                "EmployeeId": "f40d1790-d57f-4f77-a517-def8da521911",
                "EmpRef": "Payeeref6354"
            }
        ],
        "Status": "CREATED",
        "StatusTs": "2026-02-17 23:30:25 -05:00",
        "Info": null,
        "Errors": null
    }
],
"ErrorRecords": null,
"Errors": null
}