Acerta: Filtering employees by company ID

By default, the Acerta connector uses a static employerId set in your connector configuration to scope all employee requests. If you need to fetch employees for a different employer on a per-request basis, you can pass the filter[company_id] parameter directly in the request URL - without changing your connector settings.

Add filter[company_id] as a query parameter when calling the list employees endpoint:

GET /hris/employees?filter[company_id]=YOUR_EMPLOYER_ID

When provided, the filter value takes precedence over the static employerId in your connector configuration. If no filter is passed, the request falls back to the existing setting - so all existing integrations continue to work without any changes.

This is useful if you manage multiple employers under the same Acerta account and need to switch between them per request, rather than maintaining separate connector configurations for each.

• Acerta connector documentation

• HRIS API reference – List Employees