---
title: "ktm shell list"
description: "List recent shell actions (last 24h by default)"
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 recent shell actions (last 24h by default)

## Usage

```bash
ktm shell list [flags]
```

## Examples

```bash
ktm shell list --product 123
ktm shell list --product 123 --status D
# Widen the default 24h window: a duration back from now, or ISO timestamps
ktm shell list --product 123 --from-date 72h
ktm shell list --product 123 --from-date 2026-03-15T00:00:00Z --to-date 2026-03-16T00:00:00Z
# Poll for async events (wait SMS, USSD push) since session start
ktm shell list --product 123 --owner 0789800356 --from-date 2026-03-15T19:29:17Z --ordering -created
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--from-date` | string |  | Only show shells created after this time — ISO 8601 timestamp or a duration like 72h (that long ago). Defaults to the last 24h |
| `--ordering` | string |  | Sort order: '-created' (newest first), 'created' (oldest first) |
| `--owner` | string |  | Filter by device identifier |
| `--product` | int |  | Filter by product ID |
| `--status` | string |  | Filter by status (P/D/O/B/C/T/M) |
| `--to-date` | string |  | Only show shells created before this time — ISO 8601 timestamp or a duration like 30m (that long ago) |

## Related

- [`ktm shell`](/cli/commands/shell)

<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>