## List Results

`$ boltz-api small-molecule:design list-results`

**get** `/compute/v1/small-molecule/design/{id}/results`

Retrieve paginated results from a design run

### Parameters

- `--id: string`

  Design run ID

- `--after-id: optional string`

  Return results after this ID

- `--before-id: optional string`

  Return results before this ID

- `--limit: optional number`

  Max results to return. Defaults to 100.

- `--workspace-id: optional string`

  Workspace ID. Only used with admin API keys. Ignored (or validated) for workspace-scoped keys.

### Returns

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

  - `data: array of object { id, artifacts, created_at, 3 more }`

    - `id: string`

      Unique result ID

    - `artifacts: object { archive, structure }`

      - `archive: object { url, url_expires_at }`

        - `url: string`

          URL to download the file

        - `url_expires_at: string`

          When the presigned URL expires

      - `structure: object { url, url_expires_at }`

        - `url: string`

          URL to download the file

        - `url_expires_at: string`

          When the presigned URL expires

    - `created_at: string`

    - `metrics: object { binding_confidence, complex_iplddt, complex_plddt, 4 more }`

      Scoring metrics for a designed small molecule

      - `binding_confidence: number`

        Confidence that the molecule binds the target (0-1). Primary metric for hit discovery.

      - `complex_iplddt: number`

        Interface pLDDT for the complex (0-1 float). Confidence at the binding interface.

      - `complex_plddt: number`

        pLDDT for the full complex (0-1 float).

      - `iptm: number`

        Interface predicted TM score (0-1). Confidence in relative positioning of ligand and protein.

      - `optimization_score: number`

        Binding strength ranking score for lead optimization. Higher values indicate stronger predicted binding.

      - `ptm: number`

        Predicted TM score (0-1). Global structure quality metric.

      - `structure_confidence: number`

        Confidence in the predicted 3D structure (0-1).

    - `smiles: string`

      SMILES string of the designed molecule

    - `warnings: optional array of object { code, message }`

      Warnings about potential quality issues with this result.

      - `code: string`

        Machine-readable warning code (e.g. "low_confidence", "unusual_geometry")

      - `message: string`

        Human-readable description of the warning

  - `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 small-molecule:design list-results \
  --id id
```