Skip to main content
Version: 1.7.3

Overview

Illinois employers liable for unemployment insurance must file quarterly wage and contribution reports with the Illinois Department of Employment Security (IDES).

The TaxBandits API supports the automation of Form UI-3/40, Illinois's quarterly UI contribution and wage report.

Forms supported​

FormTypeFiling frequencyDue date
Form UI-3/40UIQuarterlyLast day of the month following the quarter end

Key compliance notes​

  • Wage base. UI contributions apply to wages up to the annual per-employee wage base set by IDES.

  • Zero filing required. Form UI-3/40 must be filed every quarter, even if no contributions are due.

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 Illinois's withholding Form UI-3/40.

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 UI-3/40 quarterly UI contribution and wage report for the specified quarter.

  • Update — Modifies the details of a previously created Form UI-3/40 report before it's transmitted.

  • Get — Retrieves the details of a previously created Form UI-3/40 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.