Skip to main content
Version: 1.7.3

Organization Overview

The Organization endpoints expose the employer's company profile and its employees (individuals). Use them to read the company record, page through the employee directory, and pull detailed profile and employment information for specific employees.

Every Organization endpoint requires the X-TaxBandits-Version header (1.0.0). Most endpoints also require the entity_ids query parameter (the organization ID) — except GET /organization/company/by-tin, which takes a tin instead. See the Payroll Integration API Overview for prerequisites and the response envelope.

Key elements​

  • entity_ids — The organization ID. Required on every call.
  • individual_id — An employee UUID returned by GET /organization/directory. Used to look up individual and employment details, and to enroll employees in benefits.

Organization Endpoints​

  • Company by TIN - GET /organization/company/by-tin — Look up a company by its TIN/EIN without needing the organization ID.
  • Company - GET /organization/company — Retrieve the company profile (name, address, EIN, entity type) for the employer.
  • Directory - GET /organization/directory — Return a paginated list of all employees (individuals) for the employer. Returns individual_id values.
  • Individual - POST /organization/individual — Return detailed profile information (name, DOB, address) for one or more employees in a single batch call.
  • Employment - POST /organization/employment — Return employment details (start date, job title, employment type, compensation) for one or more employees.