Access: System, Admin, and ClientAdmin users only.

The endpoint returns one complete, deterministic value set for the workforce-counts filter dimensions over the caller-supplied inclusive from/to window. Both dates are required and are used verbatim; no granularity, groupBy, period-boundary defaulting, or filter parameters are accepted by this endpoint.

The facet load applies no omitted-statuses-to-active default. Values that exist only for terminated or inactive in-window employment rows are retained. The residentialCountries facet is person-level and includes valid people without an in-window employment snapshot; all other derived facets are employment-derived.

The response contains non-PII keys only: static employee-type and status enum strings, normalized country codes, department and position IDs, and work-location keys. No names, labels, addresses, or person identifiers are returned. Historical-only or soft-deleted department, position, and work-location IDs may therefore have no label in the caller's current Valid-only lookup lists.

Work from home is emitted as the synthetic key { "workLocationId": null, "isWorkFromHome": true }; real offices are emitted as { "workLocationId": id, "isWorkFromHome": false }. Each derived dimension is capped at 5,000 distinct values and returns 400 Bad Request instead of silently truncating when the cap is exceeded. Company-not-found uses the same 404 surface as the workforce-counts actions.