---
title: "ktm resources list"
description: "List available resources (SIMs, web agents, smartphones) for a product"
sidebarTitle: "list"
lastUpdated: "2026-09-23"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

{/* GENERATED FILE: do not edit by hand. Regenerate with: node scripts/generate.mjs */}

List available resources (SIMs, web agents, smartphones) for a product

## Usage

```bash
ktm resources list [flags]
```

## Examples

```bash
# List available resources for a product (default: --available=true)
ktm resources list --product acme~web-portal

# List only SIMs
ktm resources list --product acme~web-portal --type sim

# List only web agents (table format)
ktm resources list --product acme~web-portal --type web-agent -o table

# List all resources including offline
ktm resources list --product acme~web-portal --available=false
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--available` | boolean | `true` | Show only available/online resources (default: true, set --available=false to include offline) |
| `--product` | string |  | Product slug (required, from 'products list') |
| `--type` | string |  | Resource type filter: sim, web-agent, smartphone (omit for all) |

## Details

List hardware and software resources available for test execution.

Resources are scoped to a product. Use --type to filter by resource type,
or omit it to fetch all three types.

Resource types and their identifiers (used in campaign JSON):
  sim         — SIM cards, identified by national_msisdn
  web-agent   — Ethernet/web agents, identified by hostname
  smartphone  — Smartphones, identified by uuid

These identifiers are used as values for owner-type variables and direct_owners
when constructing campaign JSON via "ci build".

For test creation: these identifiers are used as the "owner" field in test actions.
  SIM national_msisdn      → owner for SIM action types (USSD, SMS_GET, DATA_*, CALL_*, etc.)
  Web-agent hostname       → owner for ETHERNET action types (ETH_HTTP_API, ETH_PING, etc.)
  Smartphone UUID          → owner for SMARTPHONE action types

Smartphone installed apps are not part of this listing — use
"ktm resources get <serial> --include-apps" to see the apps on one device.

SIM and smartphone status is an object with value and detail fields (e.g.
"Available", "Disconnected (Sim not inserted)"). EthernetAgent status is a boolean.
By default only available/online resources are shown; use --available=false to include
offline resources.

## Related

- [`ktm resources`](/cli/commands/resources)
- [`ktm resources get`](/cli/commands/resources/get)
- [`ktm ci build`](/cli/commands/ci/build)
- [`ktm products list`](/cli/commands/products/list)

<Note>
  Global flags (`--output`, `--debug`, `--host`, …) apply to every command. See the [command reference overview](/cli/commands/overview).
</Note>

## What's next?

<Columns cols={2}>
  <Card title="All commands" icon="terminal" href="/cli/commands/overview">
    Browse the full CLI reference.
  </Card>
  <Card title="Get started" icon="rocket" href="/cli/getting-started">
    Install the CLI and authenticate.
  </Card>
</Columns>