---
title: "system.alarm.getRosters"
description: "This function returns a mapping of roster names to a list of usernames contained in the roster."
---

# system.alarm.getRosters

> This function returns a mapping of roster names to a list of usernames contained in the roster.

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

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

## Syntax
`system.alarm.getRosters()`

### Parameters
None

### Returns
**PyDict** - A dictionary that maps roster names to a List of usernames in the roster. The List of usernames may be empty if no users have been added to the roster.
    
### Scope
All

## Code Examples
```python title="Example #1"
# This script will get all the rosters and list the users in them.
rosters = system.alarm.getRosters()
for key, values in rosters.iteritems():
    # key is the roster name, values is a dict of usernames
    print 'Roster', key, 'contains these users:'
    for value in values:
        print '  ', value
```

```python title="Output"
Roster Admins contains these users:
   admin
Roster Supervisors contains these users:
   asmith
   jdoe
```