> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roark.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# roark call list

> List calls

Returns a paginated list of calls for the authenticated project.

```bash Synopsis theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark call list [options]
```

> [!NOTE]
>
> Calls `GET /v1/call`

## Options

**--limit** `integer`

Maximum number of calls to return (default: 20, max: 100).

**--after** `string`

Cursor for pagination - use the nextCursor value from a previous response.

**--sort-by** `string`

Field to sort by (default: createdAt). One of `createdAt`, `startedAt`, `endedAt`, `duration`, `title`, `status`

**--sort-direction** `string`

Sort direction (default: desc). One of `asc`, `desc`

**--status** `string`

Filter by call status. One of `RINGING`, `IN_PROGRESS`, `ENDED`

**--search-text** `string`

Search text to filter calls by title, summary, or transcript.

**--simulation-run-plan-job-id** `string`

Filter by simulation run plan job ID to get all calls from a specific simulation batch.

**--simulation-run-plan-job-ids** `string`

Calls from any of these simulation runs (run plan job ids), comma-separated, at most 100.

**--simulation-run-plan-ids** `string`

Calls from every run of any of these run plans, comma-separated, at most 100.

**--counted-in-results** `string`

true: only simulated calls their run's results count (not invalidated, for example because the agent never spoke). false: only the simulated calls the results leave out, each invalidated. Live calls, and calls removed from their run, match neither. One of `true`, `false`

**--exclude-hidden-runs** `string`

true: leave out calls from runs hidden from the runs list. Live calls stay in. false is the same as leaving it out. One of `true`, `false`

**--properties** `object`

Filter on custom properties, one entry per property name: properties\[\<name>]\[exists]=true keeps calls that have the property set (whatever the value), properties\[\<name>]\[exists]=false keeps calls missing it (never sent, sent as null, or removed). A property the project has never seen is missing on every call. Names match the way properties are stored, so planTier and plan\_tier are one property. At most 20 properties; a name taken by a built-in call filter, such as status, is rejected with 400.

## Example

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark call list
```

Every command also takes the [global options](/cli-reference/overview.md#global-options) and sets one
of the [exit codes](/cli-reference/overview.md#exit-codes).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.