Skip to main content
Version: 1.7.3

Overview

New Mexico employers subject to the state's Unemployment Compensation Law must file quarterly wage and contribution reports with the New Mexico Department of Workforce Solutions (NMDWS).

The TaxBandits API supports the automation of Forms ES-903A, New Mexico's quarterly UI wage and contribution reports.

Forms supported​

FormTypeFiling frequencyDue date
Form ES-903AUIQuarterlyLast day of the month following the quarter end

Key compliance notes​

  • Two-part filing. Form ES-903A reports total gross and taxable wages and contributions due; lists individual employee wage detail alongside it.

  • Zero filing required. A report must be filed every quarter, even if no wages were paid.

Before filing, you can simulate the entire verification flow in our Sandbox environment without submitting real data to state agencies. See how

Available endpoints​

Each endpoint below is specific to New Mexico's withholding Form ES-903A.

To use the following endpoints, you must first call the Auth method to obtain an access token. Include this token in your request header as a Bearer token. Refer to OAuth 2.0 Authentication for details on JWT-based authentication.

  • Create — Generates a new Form ES-903A quarterly UI wage and contribution report for the specified quarter.

  • Update — Modifies the details of a previously created Form ES-903A report before it's transmitted.

  • Get — Retrieves the details of a previously created Form ES-903A report.

Common endpoints (utility)​

These endpoints share the same payload structure across all states, and apply uniformly whether you're working with a withholding form or a UI form:

  • List: Retrieves a list of forms created for a specific business or period.
  • Delete: Removes an in-progress form before it's transmitted to the state.
  • Transmit: Submits a completed form to the corresponding state agency.
  • RequestPdfUrls: Returns a link to download the PDF version of a form (final).
  • Status: Checks whether a submitted form was accepted or rejected by the state.

As an alternative to polling the Status endpoint, you can configure a webhook for the event type Status Payroll Filings Status Change to receive automated status updates.