---
title: "system.user.getUsers"
description: "Retrieves the list of users in a specific user source."
---

# system.user.getUsers

> Retrieves the list of users in a specific user source.

This function is used in **Python Scripting**.

## Description
Retrieves the list of users in a specific user source. The "User" objects that are returned contain all of the information about that user, except for the user's password.

## Client Permission Restrictions
This scripting function has no [Client Permission](projects\project-properties\project-properties.md#client---permissions) restrictions.

## Syntax
`system.user.getUsers(userSource)`

### Parameters
Type | Parameter | Description 
------- | ------- | ------
String | `userSource` | The name of the user source to find the users in.

### Returns
**List** - A List of User objects.
### Scope
Gateway, Designer, Client

## User Object
You can access most of the basic user properties via a call to "get" which returns a null value if the requested item is not present.

For example: `user.get("firstname")` will return that user's first name, or a null value if a name hasn't been set. The following list represents the various values you may use in this manner:
- username
- firstname
- lastname
- notes
- schedule
- language

In addition to these properties, the user object has other methods on it to retrieve more information:
- **user.getId()** - returns the internal identifier object that the backing user source needs to identify this user
- **user.getRoles()** - returns a sequence of strings representing the roles that this user belongs to
- **user.getContactInfo()** - returns a sequence of ContactInfo objects. Each of these objects will have a contactType and value property representing the contact information, both strings.
- **user.getScheduleAdjustments()** - returns a sequence of ScheduleAdjustment objects. Each of these objects will have two date properties, "start" and "end", a boolean property, "available", and a string property called "note".
- **user.getPath()** - returns a QualifiedPath object that represents this user in a deterministic manner.

## Code Examples
```python title="Example #1"
# This example will print the first and last name of all users, using the default datasource:
  
users = system.user.getUsers("")
for user in users:
    print user.get(user.FirstName) + " " + user.get(user.LastName)
```