---
title: "Search Career Paths"
method: GET
path: "/api/v2/careerhub/career-navigator/recommended-paths/{userEmail}"
tags: ["Career Navigator"]
---

# Search Career Paths

`GET /api/v2/careerhub/career-navigator/recommended-paths/{userEmail}`

## Request

- Base URL: `https://apiv2.eightfold.ai`
- URL: `https://apiv2.eightfold.ai/api/v2/careerhub/career-navigator/recommended-paths/{userEmail}`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/eightfold/apis/api-server-v2-service-service/docs/api/v2/careerhub/career-navigator/recommended-paths/:userEmail/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns career navigator recommended career paths

## Path parameters

- `userEmail` string, required

## Query parameters

- `exclude` string
- `keyList` string

## Headers

- `Authorization` string, required

## Response `200`

OK

- CareerNavigatorSearchResponseSchema
  - `careerPaths` CareerNavigatorPath[], nullable, required: List of career paths
    - `pathHighlights` string[], nullable, required: Highlights of the career path
    - `roleList` CareerNavigatorRole[], nullable, required: List of roles in the career path
      - `entityId` integer, nullable, required: Unique identifier for the role
      - `associatedEmployeesData` CareerNavigatorRoleEmployee
        - `associatedEmployeesCount` integer, nullable: Number of associated employees for the role
        - `associatedEmployeesProfiles` CareerNavigatorAssociatedEmployee[], nullable: Associated employees profiles limited to 10
          - `currentTitle` string, nullable: Current title of the employee
          - `imageUrl` string, nullable: URL for the avatar of the employee
          - `encId` string, nullable: Encoded profile id of the employee
          - `name` string, nullable: Name of the employee
      - `isCareerInterest` boolean, nullable: It indicates if the role is added as career interest
      - `encEntityId` string, nullable: Hashids-encoded role id (matches `Role.get_encoded_employee_role_id()`); use this when constructing role-detail URLs.
      - `highlights` string[], nullable: Highlights of the role
      - `recommendedPositionsCount` integer, nullable: Number of recommended positions for the role
      - `title` string, nullable, required: Title of the role
      - `skillData` CareerNavigatorSkillData
        - `requiredSkills` string[], nullable: Skills marked as required in talent design for the role
        - `roleSkills` string[], nullable: Skills defined in talent design for the role
        - `matchingSkills` string[], nullable: Profile skills expanded with synonyms from skills engine, matching role skills
        - `matchingRequiredSkills` string[], nullable: Matching required skills for the role
  - `userAdditionalData` CareerNavigatorUserAdditionalData, required
    - `currentRole` CareerNavigatorRole, required
      - `entityId` integer, nullable, required: Unique identifier for the role
      - `associatedEmployeesData` CareerNavigatorRoleEmployee
        - `associatedEmployeesCount` integer, nullable: Number of associated employees for the role
        - `associatedEmployeesProfiles` CareerNavigatorAssociatedEmployee[], nullable: Associated employees profiles limited to 10
          - `currentTitle` string, nullable: Current title of the employee
          - `imageUrl` string, nullable: URL for the avatar of the employee
          - `encId` string, nullable: Encoded profile id of the employee
          - `name` string, nullable: Name of the employee
      - `isCareerInterest` boolean, nullable: It indicates if the role is added as career interest
      - `encEntityId` string, nullable: Hashids-encoded role id (matches `Role.get_encoded_employee_role_id()`); use this when constructing role-detail URLs.
      - `highlights` string[], nullable: Highlights of the role
      - `recommendedPositionsCount` integer, nullable: Number of recommended positions for the role
      - `title` string, nullable, required: Title of the role
      - `skillData` CareerNavigatorSkillData
        - `requiredSkills` string[], nullable: Skills marked as required in talent design for the role
        - `roleSkills` string[], nullable: Skills defined in talent design for the role
        - `matchingSkills` string[], nullable: Profile skills expanded with synonyms from skills engine, matching role skills
        - `matchingRequiredSkills` string[], nullable: Matching required skills for the role
    - `currentTenure` string, nullable: Tenure in current role, fallsback to company tenure

---

[API](https://skmtc.dev/eightfold/apis/api-server-v2-service-service.md) - [All operations](https://skmtc.dev/eightfold/apis/api-server-v2-service-service/llms.txt) - [OpenAPI document](https://skmtc.dev/eightfold/apis/api-server-v2-service-service/revisions/9a8b3a927e93?raw)