---
title: "List Merit Cycle Employees"
method: GET
path: "/v1/compensationPlanning/meritCycles/{meritCycleId}/employees"
tags: ["Merit Cycle Employee API"]
---

# List Merit Cycle Employees

`GET /v1/compensationPlanning/meritCycles/{meritCycleId}/employees`

## Request

- Base URL: `https://api.pave.com`
- URL: `https://api.pave.com/v1/compensationPlanning/meritCycles/{meritCycleId}/employees`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/pave/apis/pave-external-api/docs/v1/compensationPlanning/meritCycles/:meritCycleId/employees/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of all merit cycle employees

## Path parameters

- `meritCycleId` string, required

## Query parameters

- `limit` number
- `nextCursor` string

## Response `200`

Returns a list of merit cycle employees on success

- object
  - `nextCursor` string: The next cursor to use for pagination
  - `data` MeritCycleEmployeeResponseDto[]
    - `id` string, required: The ID of the Merit Cycle Employee
    - `email` string, required: The email of the Merit Cycle Employee
    - `firstName` string, required: The first name of the Merit Cycle Employee
    - `lastName` string, required: The last name of the Merit Cycle Employee
    - `preferredName` object, nullable, required: The preferred name (if any) of the Merit Cycle Employee
    - `currencyCode` object, required: The currency code of the Merit Cycle Employee
      - `code` string: Currency Code according to ISO 4217
      - `value` string: Readable Currency Name
    - `eligibilityStatus` 'eligible' | 'ineligible', required: The eligibility status of the Merit Cycle Employee
    - `columns` object, required: The columns of the Merit Cycle Employee

---

[API](https://skmtc.dev/pave/apis/pave-external-api.md) - [All operations](https://skmtc.dev/pave/apis/pave-external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pave/apis/pave-external-api/revisions/5d166af16578?raw)