---
module: devices.device-list
title: Device List
tab: Customer
order: 10
audience: customer
---

The Device List is your full inventory of every ATM and TCR in your fleet. Use it to find a specific machine, check whether it's online and in service, and open a device to see its details.

## 🔍 Find & Filter Devices
1. Type in the **Search** box to look up a device by ID, location, and more.
2. Open the **Filters** sidebar (left edge) to narrow the list by:
   - **Group** — a saved set of devices.
   - **Device Type** — ATM or TCR.
   - **Status** — In Service, Down, Maintenance, Inactive, Agent Offline, In Supervisor, or Out of Service.
   - **Model** — the machine make/model.
   - **Agent Status** — Connected, Disconnected, or Never Connected.
   - **Agent Version** — the software version running on the device.
3. Active filters appear as tags above the table. Click the **×** on a tag to remove it, or **Clear all** to reset.

## 📋 What You're Looking At
Each row is one device. Key columns include:
- **ATM ID** — the unique identifier for the device.
- **Location** / **Institution** — where the device is and which institution owns it.
- **Model** / **Type** — the machine model and whether it's an ATM or TCR.
- **Status** — a colored badge showing the device's current service state. If the agent is offline, this shows **Agent Offline**.
- **Agent** — a colored dot for the connection (green = connected, red = disconnected, gray = never connected), the installed agent version, and a small signal bar showing download speed to the device.
- **Last Heartbeat** — the last time the device checked in.

> Use the **⚙ Columns** button to show or hide columns like Address, Terminal Comment, Last Service, and Added. Drag a column's edge to resize it, or click a column header to sort.

## ➕ Add a Device
1. Click **+ Add Device** in the toolbar.
2. Enter the required fields: **ATM ID**, **Location**, **Model**, and **Address** (Institution is set for you if you only manage one).
3. Click **📍 Lookup Coords** to fill in map coordinates from the address automatically, or enter latitude/longitude by hand.
4. Click **Create Device**.

## 💡 Good to Know
- Click any row to open its detail panel, with **Properties**, **Modules**, and **Command Center** tabs.
- Turn on **Auto-refresh** (top right) to keep the list updating on its own, or click the **↻** button to refresh right away.
- The **Total** count and per-page controls sit above the table so you can page through large fleets.
