---
title: "List Succession Plan Incumbents"
method: GET
path: "/api/v2/careerhub/succession_plans/{positionId}/incumbents"
tags: ["Succession Plan"]
---

# List Succession Plan Incumbents

`GET /api/v2/careerhub/succession_plans/{positionId}/incumbents`

Get a list of incumbents of the succession plan. The plan is specified by the position ID in the request path. This endpoint is mainly to support getting incumbents for role-based succession plans which cannot show the incumbents in the Succession Plan Get and List endpoints.

## Path parameters

- `positionId` integer, required

## Query parameters

- `start` integer
- `limit` integer
- `query` string
- `exclude` string
- `keyList` string

## Headers

- `Authorization` string, required

## Response `200`

OK

- object
  - `data` SuccessionPlanIncumbentSchema[]
    - `externalJobId` string, nullable — Position ID associated with the incumbent in ATS/HRIS
    - `employeeId` string, nullable — ATS/HRIS employee ID of the incumbent
    - `profileId` integer, nullable — Eightfold decoded profile ID (numeric) of the incumbent
  - `meta` MetaSchema
    - `totalCount` integer, nullable
    - `pageTotalCount` integer, nullable
    - `pageStartIndex` integer, nullable

---

[API](https://skmtc.net/eightfold/apis/api-server-v2-service-service.md) · [All operations](https://skmtc.net/eightfold/apis/api-server-v2-service-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eightfold/api-server-v2-service-service/revisions/0fb26f4e41bf/schema)