## List

`$ boltz-api protein:design list`

**get** `/compute/v1/protein/design`

List protein design runs, optionally filtered by workspace

### Parameters

- `--after-id: optional string`

  Return results after this ID

- `--before-id: optional string`

  Return results before this ID

- `--limit: optional number`

  Max items to return. Defaults to 100.

- `--workspace-id: optional string`

  Filter by workspace ID. Only used with admin API keys. If not provided, defaults to the workspace associated with the API key, or the default workspace for admin keys.

### Returns

- `ListProteinDesignRunsResponse: object { data, first_id, has_more, last_id }`

  - `data: array of object { id, completed_at, created_at, 11 more }`

    - `id: string`

      Unique ProteinDesignRunSummary identifier

    - `completed_at: string`

    - `created_at: string`

    - `data_deleted_at: string`

      When the input, output, and result data was permanently deleted. Null if data has not been deleted.

    - `engine: "boltz-protein-design"`

      Engine used for protein design

      - `"boltz-protein-design"`

    - `engine_version: string`

      Engine version used for protein design

    - `error: object { code, message, details }`

      - `code: string`

        Machine-readable error code

      - `message: string`

        Human-readable error message

      - `details: optional unknown`

        Additional field-level error details keyed by input path, when available.

    - `livemode: boolean`

      Whether this resource was created with a live API key.

    - `progress: object { num_proteins_generated, total_proteins_to_generate, latest_result_id }`

      - `num_proteins_generated: number`

        Number of protein binders generated so far

      - `total_proteins_to_generate: number`

        Total number of protein binders requested

      - `latest_result_id: optional string`

        ID of the most recently generated result

    - `started_at: string`

    - `status: "pending" or "running" or "succeeded" or 2 more`

      - `"pending"`

      - `"running"`

      - `"succeeded"`

      - `"failed"`

      - `"stopped"`

    - `stopped_at: string`

    - `workspace_id: string`

      Workspace ID

    - `idempotency_key: optional string`

      Client-provided idempotency key

  - `first_id: string`

    ID of the first item. Use as before_id for the previous page.

  - `has_more: boolean`

  - `last_id: string`

    ID of the last item. Use as after_id for the next page.

### Example

```cli
boltz-api protein:design list
```