# List Merit Cycles

Returns a list of all merit cycles

Endpoint: GET /v1/compensationPlanning/meritCycles
Version: 1.0
Security: api-key

## Query parameters:

  - `status` (string)
    The status of the merit cycle
    Enum: "active", "inactive", "finalized"

  - `startDate` (object)
    The start date of the merit cycle

  - `limit` (number)
    The number of merit cycles to return

  - `nextCursor` (string)
    The next cursor to paginate through the list of merit cycles
    Example: "eyJleHRlcm5hbF9pZCI6Im1jZV8wNDdiZTg0ZC02OGQxLTRiMzYtYmU0Mi0xY2RlMTE4MjdhZTkifQ=="

## Response 200 fields (application/json):

  - `nextCursor` (string)
    The next cursor to use for pagination
    Example: "eyJleHRlcm5hbF9pZCI6Im1jZV8wNDdiZTg0ZC02OGQxLTRiMzYtYmU0Mi0xY2RlMTE4MjdhZTkifQ=="

  - `data` (array)

  - `data.id` (string, required)
    The ID of the Merit Cycle
    Example: "mc_12345678-1234-5678-9012-123456789012"

  - `data.name` (string, required)
    The name of the Merit Cycle
    Example: "H1 Merit Cycle"

  - `data.startDate` (string, required)
    The start date of the Merit Cycle
    Example: "2025-01-01T00:00:00.000Z"

  - `data.endDate` (string, required)
    The end date of the Merit Cycle
    Example: "2025-01-31T00:00:00.000Z"

  - `data.createdDate` (string, required)
    The date the Merit Cycle was created
    Example: "2024-06-17T18:55:43.000Z"

  - `data.status` (string, required)
    The status of the Merit Cycle
    Enum: "active", "inactive", "finalized"