# Get Users

GET /

#### Description

Retrieves a list of all users in an organization, including their names, roles, and status information.

Endpoint: GET /
Version: 1.0
Security: oauth2

## Query parameters:

  - `expand` (string)
    Comma separated list of fields to expand.  Supported values: identityProviders, organizationRoleId.

  - `includeDeactivated` (boolean)
    Whether or not to include deactivated users in the response.

## Response 200 fields (application/json):

  - `id` (string)
    The unique identifier of the organization user.
    Example: "82182460-f0cf-11ed-9f4f-0e9de14f3c22"

  - `status` (string)
    The status of the organization user.
    Enum: "active", "archived", "deleted", "pending", "canceled"

  - `email` (string)
    The email address of the organization user.
    Example: "john.smith@example.com"

  - `givenName` (string)
    The given name of the organization user.
    Example: "John"

  - `surname` (string)
    The surname of the organization user.
    Example: "Smith"

  - `language` (string)
    The language preference of the organization user.
    Example: "en"

  - `locale` (string)
    The locale preference of the organization user.
    Example: "US"

  - `timeZone` (string)
    The time zone preference of the organization user.
    Example: "America/Los_Angeles"

  - `userId` (string)
    The user identifier of the organization user.
    Example: "8217610f-f0cf-11ed-9f4f-0e9de14f3c22"

  - `type` (string)
    The type of organization user.
    Enum: "activeUser", "contact", "deactivatedUser", "serviceAccount", "deactivatedServiceAccount", "syncServiceAccount", "deactivatedSyncServiceAccount"

  - `externalUserLinks` (array)

  - `externalUserLinks.id` (string)
    The unique identifier of the external user link.

  - `externalUserLinks.orgId` (string)
    The unique identifier of the organization the link belongs to.

  - `externalUserLinks.userId` (string)
    The unique identifier of the user the link belongs to.

  - `externalUserLinks.orgUserId` (string)
    The unique identifier of the organization user the link belongs to.

  - `externalUserLinks.source` (string)
    The name of the external source.

  - `externalUserLinks.externalUserId` (string)
    The unique identifier of the external user in the external source.

  - `externalUserLinks.userUpdatedOn` (string)
    The date and time the user link was last updated (ISO-8601 format).

  - `externalUserLinks.givenName` (string)
    The given name of the external user.

  - `externalUserLinks.surname` (string)
    The surname of the external user.