Get employee census data

get

https://api.hibob.com/v1/payroll/hub/us/employees

Fetch payroll-related profile fields for a batch of Bob employees.

Beta. Returns payroll-relevant employee profile fields (census data) for the
requested Bob employee IDs. Pass IDs as a comma-separated value on the
employeeIds query parameter (maximum 25 IDs per request). Employees outside
the caller's authorized scope are silently filtered out, not returned as errors.

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.

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.