---
title: "List all pay cycles"
method: GET
path: "/pay_cycles"
tags: ["PayCycles"]
---

# List all pay cycles

`GET /pay_cycles`

## Request

- Base URL: `https://app.hireart.com/api/v2`
- URL: `https://app.hireart.com/api/v2/pay_cycles`
- Auth: HTTP bearer

## Query parameters

- `page` integer
- `per_page` integer
- `worker_id` string
- `period` string, date
- `period_gt` string, date
- `period_gte` string, date
- `period_lt` string, date
- `period_lte` string, date

## Response `200`

Successful response

- PayCycleList
  - `object` 'list', required
  - `page` integer, required
  - `per_page` integer, required
  - `total_count` integer, required
  - `total_pages` integer, required
  - `data` PayCycle[], required
    - `object` 'pay_cycle', required
    - `id` string, required
    - `period` string, date, required
    - `hours_submitted_at` string, date-time, nullable
    - `locked_at` string, date-time, nullable

## Other responses

- `401`: Unauthorized
- `422`: Invalid query parameters
- `429`: Rate limit exceeded (100 requests per 60 seconds per API key)
- `500`: Internal server error

---

[API](https://skmtc.dev/hireart/apis/hireart-api.md) - [All operations](https://skmtc.dev/hireart/apis/hireart-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hireart/apis/hireart-api/revisions/41935c8fd584?raw)