---
title: "List Merit Cycles"
method: GET
path: "/v1/compensationPlanning/meritCycles"
tags: ["Merit Cycle API"]
---

# List Merit Cycles

`GET /v1/compensationPlanning/meritCycles`

Returns a list of all merit cycles

## Query parameters

- `status` 'active' | 'inactive' | 'finalized'
- `startDate` object
  - `gt` string, YYYY-MM-DD — Greater than the start date
  - `gte` string, YYYY-MM-DD — Greater than or equal to the start date
  - `lt` string, YYYY-MM-DD — Less than the start date
  - `lte` string, YYYY-MM-DD — Less than or equal to the start date
- `limit` number
- `nextCursor` string

## Response `200`

Returns a list of merit cycles on success

- object
  - `nextCursor` string — The next cursor to use for pagination
  - `data` MeritCycleResponseDto[]
    - `id` string, required — The ID of the Merit Cycle
    - `name` string, required — The name of the Merit Cycle
    - `startDate` string, date-time, required — The start date of the Merit Cycle
    - `endDate` string, date-time, required — The end date of the Merit Cycle
    - `createdDate` string, date-time, required — The date the Merit Cycle was created
    - `status` 'active' | 'inactive' | 'finalized', required — The status of the Merit Cycle

---

[API](https://skmtc.net/pave/apis/pave-external-api.md) · [All operations](https://skmtc.net/pave/apis/pave-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pave/pave-external-api/versions/5d166af16578/schema)