---
title: "system.alarm.getShelvedPaths"
description: "Returns a list of ShelvedPath objects, which each represent a shelved alarm."
---

# system.alarm.getShelvedPaths

> Returns a list of ShelvedPath objects, which each represent a shelved alarm.

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.getShelvedPaths()`

### Parameters
Nothing

### Returns
**List** - A list of ShelvedPath objects. ShelvedPath objects can be examined with getExpiration, getHitCount, getPath, getShelveTime, getUser, and isExpired.
    
### Scope
All, Client, or Gateway

## Code Examples
```python title="Example #1"
# The following code prints a list of the shelved alarms paths and prints them to the console.
paths = system.alarm.getShelvedPaths()
for p in paths:
   print "Path: %s, Shelved by: %s, expires: %s, is expired? %s" % (p.getPath(), p.getUser(), p.getExpiration(), p.isExpired())
```