List pay cycles for employer

get

https://api.hibob.com/v1/payroll/hub/us/employers/{employerId}/pay-cycles

Discover pay cycles for an employer, with optional date filters and cursor pagination.

Beta. Discovers pay cycles for an employer. Use during partner onboarding
for historical paycheck sync, or to find a payCycleId to pass to the pay
cycle / paychecks endpoints. Supports optional date filters and cursor pagination.

Rate limit: 5 requests per minute per authenticated caller.

Query parameter naming: start_date and end_date use snake_case (not
camelCase like employeeIds elsewhere in this API). The running service
accepts only these spellings today.

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.