---
title: "system.device.listDevices"
description: "Returns a dataset of information about each configured device."
---

# system.device.listDevices

> Returns a dataset of information about each configured device.

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

## Description

Returns a dataset of information about each configured device. Each row represents a single device.

## 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.device.listDevices()`

### Parameters
Nothing.

### Returns
**Dataset** - A dataset, where each row represents a device. Contains 4 columns:
- Name
- Enabled
- State
- Driver

### Scope
Gateway, Vision Client, Perspective Session

## Code Examples

```python title="Code Snippet - Listing Devices Configured on Your Gateway"
deviceDataset = system.device.listDevices()
 
# Assign the deviceDataset to a Power Table. This example assumes
# the Power Table is in the same container as the component that called this script
event.source.parent.getComponent('Power Table').data = deviceDataset
```