---
title: "Get User Skills for a Specific User"
method: GET
path: "/api/v2/users/{id}/user-skills"
tags: ["User"]
---

# Get User Skills for a Specific User

`GET /api/v2/users/{id}/user-skills`

This endpoint retrieves all user skills for a specific user. The ID can be any of the ID as shown in the API, employee ID, or email address. You can use the identifier URL parameter to switch between types. You can retrieve a user by specifying the ID as a path parameter or specifying an identifier as a query string URL parameter. For example, `https://api.betatest.degreed.com/api/v2/users/<email_value>/user-skills?identifier=email`<h3>Required Scope</h3>`users:read`, `users:write` or `user_skills:read`

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer
- `identifier` string

## Response `200`

Success

- ListedUserSkill
  - `links` SelfWithNextLink
    - `self` string
    - `next` string
  - `data` UserSkillData[]
    - `type` string, nullable
    - `id` string, nullable
    - `attributes` UserSkillDataAttributes
      - `employee-id` string, nullable — The unique employee identifier for the user.
      - `skill-id` string, nullable — The unique skill identifier for the user.
      - `skill-name` string, nullable — The skill name identifier for the user.
      - `is-focus` boolean — Indicates whether this is the user's focus skill.
      - `is-endorsed` boolean — Indicates whether this skill is endorsed. Endorsed Skills indicate that a learning professional in your organization reviewed and validated it.
      - `target-rating` integer, nullable — Desired rating for the skill. This value is the highest target rating for this skill out of skill plans followed and authored by the user.
      - `followed-at` string, date-time — Date the skill was followed. (UTC)
      - `degreed-url` string
      - `source` string — The skill source the skill belongs to.
    - `links` SelfLink
      - `self` string
    - `relationships` UserSkillRelationshipsInner[]
      - `user` UserRelationship
        - `data` UserRelationshipData
          - `id` string, nullable
          - `type` string, nullable

---

[API](https://skmtc.net/degreed/apis/degreed-api-web.md) · [All operations](https://skmtc.net/degreed/apis/degreed-api-web/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/degreed/degreed-api-web/versions/4a22b709515c/schema)