---
title: "Get All Users"
method: GET
path: "/api/v2/users"
tags: ["User"]
---

# Get All Users

`GET /api/v2/users`

This endpoint retrieves all users for the current organization. <br><br>For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will return users for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization. <h3>Required Scope</h3>`users:read` or `users:write`

## Query parameters

- `next` string
- `limit` integer
- `filter[start_date]` string, date
- `filter[end_date]` string, date

## Headers

- `X-Degreed-Organization-Code` string

## Response `200`

Success

- ListedUser
  - `links` SelfWithNextLink
    - `self` string
    - `next` string
  - `data` UserData[]
    - `type` string, nullable
    - `id` string, nullable
    - `attributes` UserDataAttributes
      - `employee-id` string, nullable — The unique employee identifier.
      - `first-name` string, nullable — The first name of the user.
      - `last-name` string, nullable — The last name of the user.
      - `full-name` string, nullable — The full name of the user.
      - `organization-email` string, nullable — Email used within the organization.
      - `personal-email` string, nullable — The personal email address for the user.
      - `profile-visibility` string, nullable — Visibility of the profile, can be `UseOrganizationDefault`, `Everyone`, `Organization`, or `Private`.
      - `bio` string, nullable — Short biography of the user.
      - `location` string, nullable — The location of the user.
      - `profile-image-url` string, nullable — The user ID.
      - `login-disabled` boolean — Ability for the user to login.
      - `restricted` boolean — Indicates whether the user is restricted from changing certain fields in the user interface, which are primarily related to entering free-text, such as commenting.
      - `is-active-learner` boolean — Indicates whether the user is an active learner.
      - `is-managed` boolean — Indicates whether the user is restricted from changing their personal profile settings, specifically First Name, Last Name, Email, and Job Role.
      - `permission-role` string, nullable — One of `Admin`, `LearningProfessional`, `Manager`, `Member`, `CareerProfessional` or `TechnicalAdmin`.
      - `job-role` string, nullable — The job role of the user.
      - `alias-uid` string, nullable — Unique alias identifier for the user.
      - `preferred-language` string, nullable — The preferred language of the user.
      - `display-language` string, nullable — The language that displays on buttons and messages on a user's Degreed experience. This value must be a valid language code.
      - `real-time-email-notification` boolean, nullable — Indicates whether the user is set to receive real time email notifications.
      - `daily-digest-email` boolean, nullable — Indicates whether the user is signed up for the daily digest email.
      - `weekly-digest-email` boolean, nullable — Indicates whether the user is signed up for the weekly digest email.
      - `created-at` string, date-time — Date the user was created. (UTC)
      - `first-login-at` string, date-time, nullable — Date the user first logged into Degreed. (UTC)
      - `last-login-at` string, date-time, nullable — Date the user last logged into Degreed. (UTC)
      - `total-points` number, double — The users total learning points.
      - `daily-logins` integer — The number of unique days that a user has logged in.
    - `links` SelfLink
      - `self` string
    - `relationships` ManagerRelationshipsInner[]
      - `manager` UserRelationshipsInnerUser
        - `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)