---
title: "Get pay cycle by ID"
method: GET
path: "/payroll/hub/us/pay-cycles/{payCycleId}"
tags: ["Pay cycles"]
---

# Get pay cycle by ID

`GET /payroll/hub/us/pay-cycles/{payCycleId}`

## Request

- Base URL: `https://api.hibob.com/v1`
- URL: `https://api.hibob.com/v1/payroll/hub/us/pay-cycles/{payCycleId}`
- Auth: HTTP bearer

**Beta.** Returns metadata for a single pay cycle. Use after receiving a
`payroll.paycycle.paid` webhook to fetch the pay cycle window, or when you
have a `payCycleId` from
[`ListPayCyclesForEmployer`](/reference/get_payroll-hub-us-employers-employerid-pay-cycles).

**Rate limit:** 5 requests per minute per authenticated caller.

## Path parameters

- `payCycleId` string, required

## Response `200`

Success

- GetPayCycleOutput
  - `payCycleId` string, required: Unique identifier of the pay cycle.
  - `payDate` string, nullable: Date when payment is made to the employees in this cycle (ISO 8601 calendar date, `YYYY-MM-DD`). Absent for cycles that have not been paid yet.
  - `periodStart` string, required: First day of the pay period covered by this cycle.
  - `periodEnd` string, nullable: Last day of the pay period covered by this cycle. Absent for open-ended cycles.

## Other responses

- `400`: Bad request — invalid request body, validation error, or deduction rejected by US Payroll.
- `401`: Unauthorized — the OAuth 2.0 access token is missing, invalid, or expired.
- `403`: Forbidden — the authenticated caller does not have permission to perform this operation on the requested company, employer, or employee.
- `404`: Not found — the requested employer, employee, pay cycle, or deduction could not be found, or the authenticated caller is not authorized to see it.
- `429`: Too many requests — rate limit exceeded. Read the limit per operation (most reads are 5/minute, mutations 200/minute) and retry after the indicated delay.
- `500`: Internal server error — an unexpected error occurred. Retry with exponential backoff; if the error persists, contact HiBob support with the `requestId` from the response body.

---

[API](https://skmtc.dev/hibob/apis/retirement-partners-api.md) - [All operations](https://skmtc.dev/hibob/apis/retirement-partners-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hibob/apis/retirement-partners-api/revisions/5ebd2ae67958?raw)