> ## 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 simulation plan job list

> List simulation plan jobs

Returns a paginated list of simulation run plan jobs. Filter by status, plan ID, or label to find specific simulation batches.

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

> [!NOTE]
>
> Calls `GET /v1/simulation/plan/jobs`

## Options

**--limit** `integer`

Maximum number of plan jobs to return (default: 20, max: 50).

**--after** `string`

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

**--status** `string`

Filter by plan job status (PENDING, QUEUED, `CREATING_SNAPSHOTS`, `CREATING_SIMULATIONS`, `PREPARING_CAPACITY`, `RUNNING_SIMULATIONS`, COMPLETED, FAILED, `TIMED_OUT`, CANCELLED, CANCELLING, `ENDING_SIMULATIONS`). One of `PENDING`, `QUEUED`, `CREATING_SNAPSHOTS`, `CREATING_SIMULATIONS`, `PREPARING_CAPACITY`, `RUNNING_SIMULATIONS`, `COMPLETED`, `FAILED`, `TIMED_OUT`, `CANCELLED`, `CANCELLING`, `ENDING_SIMULATIONS`

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

Filter by simulation run plan ID.

**--label-id** `string`

Filter by label ID attached to the plan job. Use this if you know the label ID.

**--label-name** `string`

Filter by label name attached to the plan job. More user-friendly alternative to labelId. Case-insensitive.

## Example

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark simulation plan job 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.