# List Merit Cycle Employees

Returns a list of all merit cycle employees

Endpoint: GET /v1/compensationPlanning/meritCycles/{meritCycleId}/employees
Version: 1.0
Security: api-key

## Path parameters:

  - `meritCycleId` (string, required)
    The ID of the Merit Cycle

## Query parameters:

  - `limit` (number)
    The number of merit cycle employees to return

  - `nextCursor` (string)
    The next cursor to paginate through the list of merit cycle employees
    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 Employee
    Example: "mce_2312c64b-h5f1-46ca-8607-661a66319b91"

  - `data.email` (string, required)
    The email of the Merit Cycle Employee
    Example: "john.doe@example.com"

  - `data.firstName` (string, required)
    The first name of the Merit Cycle Employee
    Example: "John"

  - `data.lastName` (string, required)
    The last name of the Merit Cycle Employee
    Example: "Doe"

  - `data.preferredName` (object,null, required)
    The preferred name (if any) of the Merit Cycle Employee
    Example: "John"

  - `data.currencyCode` (object, required)
    The currency code of the Merit Cycle Employee
    Example: {"code":"USD","value":"United States Dollar"}

  - `data.currencyCode.code` (string)
    Currency Code according to ISO 4217
    Example: "USD"

  - `data.currencyCode.value` (string)
    Readable Currency Name
    Example: "United States Dollar"

  - `data.eligibilityStatus` (string, required)
    The eligibility status of the Merit Cycle Employee
    Enum: "eligible", "ineligible"

  - `data.columns` (object, required)
    The columns of the Merit Cycle Employee
    Example: {"department":{"name":"Department","type":"text","value":"Sales"},"employee":{"name":"Employee","type":"composite","value":{"fullName":"John Doe","jobLevel":"P4","jobTitle":"Sales Manager"}}}