Skip to main content
Version: 1.7.3

Overview

Federal law requires every employer to report newly hired and rehired employees to their state's Directory of New Hires, which forwards the data to the National Directory maintained by the Office of Child Support Services. This supports child support enforcement, reduces UI fraud, and keeps state employment records accurate.

Unlike State Withholding and UI, which model each state as its own form, the TaxBandits API handles new hire reporting through a single endpoint across all supported states. State-specific requirements are captured as conditional fields within that one payload, rather than as separate forms for each state.

Supported reporting states​

The API currently accepts the following values for ReportingState:

  • South Carolina (SC)
  • North Carolina (NC)
  • Florida (FL)
  • Texas (TX)
  • Kentucky (KY)
  • Kansas (KS)
  • Indiana (IN)

Key compliance notes​

  • One report per employee. You must generate a separate new hire report for each employee. A single report can include multiple ReportingState values for employers with multi-state employees.
  • Some fields only apply to specific states:
    • AccNum (state account number) is mandatory for Florida and Texas, and applicable for Florida, Texas, Kansas, and Kentucky.
    • SEIN applies only to Kentucky.
    • IsRegdMultiStateEmp applies only to Florida, for employers electing to report all hires to a single state as a registered multistate employer.
    • IsHealthInsurance applies only to Florida and Indiana.
    • IsEmployeeIndependentContractor applies only to Florida.
    • EmployeeSalary and SalaryFrequency apply only to Texas.
  • 20-day standard, but confirm per state. Most states require reporting within 20 days of hire, but exact deadlines vary; verify the current deadline for each ReportingState before relying on this default.

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 applies uniformly across all supported reporting states, since the payload structure is shared rather than state-specific.

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 hire report for an employee for the specified reporting state(s).
  • Update — Modifies the details of a previously created new hire report before it's transmitted.
  • List — Retrieves a list of new hire reports created for a specific business.
  • Get — Retrieves the details of a previously created new hire report.
  • Delete — Removes an in-progress new hire report before it's transmitted.
  • Transmit — Submits a completed new hire report to the state.
  • Status — Checks whether a submitted new hire report was accepted or rejected by the state.