---
title: "Get Career Planner Role"
method: GET
path: "/api/v2/careerhub/career-planner/{userEmail}/roles/{roleSection}"
tags: ["Careerhub"]
---

# Get Career Planner Role

`GET /api/v2/careerhub/career-planner/{userEmail}/roles/{roleSection}`

Returns roles for a specified section. Possible values of sections are preferred-roles and recommended-roles

## Path parameters

- `userEmail` string, required
- `roleSection` string, required

## Query parameters

- `exclude` string
- `keyList` string

## Headers

- `Authorization` string, required

## Response `200`

OK

- CareerPlannerRoleSchema
  - `role` string, nullable, required — A name of the role such as Software Engineer
  - `salary` CareerPlannerSalarySchema
    - `count` integer, nullable — The number of salary reported
    - `value` integer, nullable — Salary value
  - `isTrending` boolean, nullable — A flag indicating that the role is trending

---

[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)