Overview
Minnesota employers who withhold state income tax must file withholding returns with the Minnesota Department of Revenue. Separately, employers subject to unemployment insurance must file quarterly wage detail reports with the Minnesota Unemployment Insurance Program.
The TaxBandits API supports automating the MNWHReport for Minnesota withholding and Form MDES-1 for unemployment insurance reporting.
Forms supported
| Form | Type | Filing frequency | Due date |
|---|---|---|---|
| MNWHReport | Withholding | Quarterly | Last day of the month following the quarter end |
| Form MDES-1 | UI | Quarterly | Last day of the month following the quarter end |
Key compliance notes
- Quarterly withholding filing. Employers required to withhold Minnesota income tax must file the applicable withholding return based on their assigned filing frequency.
- UI wage reporting. Employers liable for Minnesota unemployment insurance must file Form MDES-1 and report wage information for covered employees each quarter.
- Employee wage details. The UI report includes employee-level wage information required to determine unemployment insurance liability.
- Electronic filing. TaxBandits enables employers to prepare and electronically transmit both Minnesota withholding and UI reports through the Public API.
API endpoints
For Minnesota reporting, the state-specific methods — Create, Update, and Get — differ by form because each form has its own field structure. The utility methods — List, Delete, Transmit, RequestPdfUrls, and Status — are shared across State Withholding and UI reporting.
MNWHReport (Minnesota Withholding)
- Create — Create a new Minnesota withholding return.
- Update — Update an MNWHReport that was created but not yet transmitted.
- Get — Retrieve the details of a created MNWHReport.
Form MDES-1 (Minnesota UI)
- Create — Create a new MDES-1 quarterly unemployment insurance wage report.
- Update — Update an MDES-1 report that was created but not yet transmitted.
- Get — Retrieve the details of a created MDES-1 report.
Common endpoints: For the remaining methods — List, Status, Transmit, RequestPdfUrls, and Delete, refer to the common endpoints shared across State Withholding and UI reporting.
All endpoints require an OAuth 2.0 access token. Call the Auth method and pass the token as a Bearer token in the request header.
Testing & notifications
Before filing, you can simulate the entire verification flow in our Sandbox environment without submitting real data to state agencies.
As an alternative to polling the Status endpoint, you can configure a webhook for the Status Payroll Filings Status Change event type to receive automated status updates.