---
title: "system.alarm.listPipelines"
description: "Will return a list of the available Alarm Notification Pipelines in a project."
---

# system.alarm.listPipelines

> Will return a list of the available Alarm Notification Pipelines in a project.

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

## Description
Will return a list of the available Alarm Notification Pipelines in a project. The order of the returned list is not guaranteed.

The legacy behavior of this function (7.9 and prior) did not have any parameters, and it would always check all projects for pipelines. Upon upgrade to version 8.#+, alarm pipelines were migrated to a project named "alarm-pipelines". See the [Upgrade Guide](getting-started\installing-and-upgrading\ignition-8-upgrade-guide\79to81-upgrade-guide.md#changes-to-systemalarmlistpipelines) for more details.

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

## Syntax
`system.alarm.listPipelines([projectName])`

### Parameters

| Type | Parameter | Description |
| ------- | ------- | ------- |
| String | `projectName` | The project to check alarm pipelines for. If omitted, will look for a project named "alarm-pipelines". [optional] |

### Returns
**List[String]** - A list of pipeline names. The list will be empty if no pipelines exist. Unsaved name changes will not be reflected in the list.
    
### Scope
Gateway, Vision Client, Perspective Session

## Code Examples
```python title="Example #1"
# This script will print a list of all alarm pipeline names in the current project.
project = system.util.getProjectName()
pipelines = system.alarm.listPipelines(project)
for pipeline in pipelines:
    print pipeline
```

```python title="Example #2"
# This script will retrieve all pipelines across all projects
projects = system.project.getProjectNames()
 
for p in projects:
    print "Project %s has the following alarm pipelines:" % p  
    pipelines = system.alarm.listPipelines(p)
     
    for i in pipelines:
        print "- %s" % i   
```