# `smallforce calls list`

List call history, newest first

This page is generated from the same Commander definition shipped in SmallForce CLI 0.1.13. Run `smallforce calls list --help` locally to view the same reference for your installed version.

## Complete command help

```text
Usage: smallforce calls list [options]

List call history, newest first

Options:
  --api-key <key>         SmallForce API key, or set SMALLFORCE_API_KEY
  --backend-url <url>     SmallForce backend URL, or set SMALLFORCE_BACKEND_URL
  --json                  Print stable machine-readable JSON
  --text                  Print human-readable text
  --format <format>       Output format: text or json
  --assistant-id <id>     Filter by voice assistant
  --channel <channel>     Filter channel (choices: "phone", "web")
  --cursor <cursor>       Opaque nextCursor from the previous page
  --since <time>          Only calls created at or after this time: an ISO-8601 timestamp, or a
                          duration ago such as 30m, 12h or 7d
  --until <time>          Only calls created before this time: an ISO-8601 timestamp, or a duration
                          ago such as 30m, 12h or 7d
  --number <e164>         Only calls from this caller number, E.164 (for example +15125550147)
  --include-tests         Include test calls from the assistant builder
  --limit <number>        Maximum calls (1-200)
  --status <statuses...>  Filter call statuses (choices: "created", "connecting", "active",
                          "ending", "call_completed", "recording_processing",
                          "transcript_finalizing", "completed", "failed", "rejected", "expired")
  -h, --help              display help for command
```

## Related reference

- [`smallforce calls`](/docs/cli/commands/calls): Parent command and related operations.
- [CLI installation and authentication](/docs/cli/getting-started): Install the CLI and configure an API key.
- [CLI JSON output](/docs/cli/json-output): Use stable machine-readable output in scripts and agents.