List employee deductions

get

https://api.hibob.com/v1/payroll/hub/us/employers/{employerId}/employees/deductions

Read current deductions for a batch of employees under an employer.

Beta. Returns current deductions for the requested employees under an
employer. Provide a comma-separated employeeIds query parameter (maximum
25 IDs). Results are filtered to the caller's authorized employees; unknown
or unauthorized IDs are silently dropped from the response, not returned as
errors. The response is a final list (items only) — no cursor pagination.

Rate limit: 5 requests per minute per authenticated caller.

Responses

200Success

400Bad request — invalid request body, validation error, or deduction rejected by US Payroll.

401Unauthorized — the OAuth 2.0 access token is missing, invalid, or expired.

403Forbidden — the authenticated caller does not have permission to perform this operation on the requested company, employer, or employee.

404Not found — the requested employer, employee, pay cycle, or deduction could not be found, or the authenticated caller is not authorized to see it.

429Too many requests — rate limit exceeded. Read the limit per operation (most reads are 5/minute, mutations 200/minute) and retry after the indicated delay.

500Internal server error — an unexpected error occurred. Retry with exponential backoff; if the error persists, contact HiBob support with the requestId from the response body.