---
title: "List all time periods"
method: GET
path: "/okrs/time_periods"
tags: ["time_periods"]
---

# List all time periods

`GET /okrs/time_periods`

Retrieves all time periods for the current tenant.

Time periods are automatically ordered with active periods appearing first,
followed by other periods in chronological order. Active time periods are
determined by the current tenant's OKR cycle settings.


This endpoint supports filtering and pagination through query parameters. Available ransackable attributes: uuid, name.

## Query parameters

- `page` number
- `per_page` number
- `limit` number
- `limit_max` number
- `count` string
- `q` object

## Other responses

- `400` — Bad Request - Invalid parameters or malformed request
- `401` — Unauthorized - Invalid or missing authentication
- `403` — Forbidden - User lacks permission to access this resource
- `404` — Not Found - Resource does not exist
- `422` — Unprocessable Entity - Invalid request parameters or validation errors
- `429` — Too Many Requests - Rate limit exceeded
- `500` — Internal Server Error - Unexpected server error

---

[API](https://skmtc.net/rhythms/apis/rhythms-params-in-body.md) · [All operations](https://skmtc.net/rhythms/apis/rhythms-params-in-body/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rhythms/rhythms-params-in-body/revisions/a67e54becfe9/schema)