## List Results

`protein.design.list_results(strid, DesignListResultsParams**kwargs)  -> SyncCursorPage[DesignListResultsResponse]`

**get** `/compute/v1/protein/design/{id}/results`

Retrieve paginated results from a protein design run

### Parameters

- `id: str`

- `after_id: Optional[str]`

  Return results after this ID

- `before_id: Optional[str]`

  Return results before this ID

- `limit: Optional[int]`

  Max results to return. Defaults to 100.

- `workspace_id: Optional[str]`

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

### Returns

- `class DesignListResultsResponse: …`

  A single generated protein design

  - `id: str`

    Unique result ID

  - `artifacts: Artifacts`

    - `archive: ArtifactsArchive`

      - `url: str`

        URL to download the file

      - `url_expires_at: datetime`

        When the presigned URL expires

    - `structure: Optional[ArtifactsStructure]`

      - `url: str`

        URL to download the file

      - `url_expires_at: datetime`

        When the presigned URL expires

  - `created_at: datetime`

  - `entities: List[Entity]`

    Entities of the designed binder complex. Includes both designed entities and fixed entities from the input.

    - `class EntityProteinEntity: …`

      - `chain_ids: List[str]`

        Chain IDs for this entity

      - `type: Literal["protein"]`

        - `"protein"`

      - `value: str`

        Amino acid sequence (one-letter codes)

      - `cyclic: Optional[bool]`

        Whether the sequence is cyclic

      - `modifications: Optional[List[EntityProteinEntityModification]]`

        Post-translational modifications. Optional; defaults to an empty list when omitted.

        - `class EntityProteinEntityModificationCcdModification: …`

          - `residue_index: int`

            0-based index of the residue to modify

          - `type: Literal["ccd"]`

            - `"ccd"`

          - `value: str`

            CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for phosphoserine)

        - `class EntityProteinEntityModificationSmilesModification: …`

          - `residue_index: int`

            0-based index of the residue to modify

          - `type: Literal["smiles"]`

            - `"smiles"`

          - `value: str`

            SMILES string for the modification

    - `class EntityRnaEntity: …`

      - `chain_ids: List[str]`

        Chain IDs for this entity

      - `type: Literal["rna"]`

        - `"rna"`

      - `value: str`

        RNA nucleotide sequence (A, C, G, U, N)

      - `cyclic: Optional[bool]`

        Whether the sequence is cyclic

      - `modifications: Optional[List[EntityRnaEntityModification]]`

        Chemical modifications. Optional; defaults to an empty list when omitted.

        - `class EntityRnaEntityModificationCcdModification: …`

          - `residue_index: int`

            0-based index of the residue to modify

          - `type: Literal["ccd"]`

            - `"ccd"`

          - `value: str`

            CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for phosphoserine)

        - `class EntityRnaEntityModificationSmilesModification: …`

          - `residue_index: int`

            0-based index of the residue to modify

          - `type: Literal["smiles"]`

            - `"smiles"`

          - `value: str`

            SMILES string for the modification

    - `class EntityDnaEntity: …`

      - `chain_ids: List[str]`

        Chain IDs for this entity

      - `type: Literal["dna"]`

        - `"dna"`

      - `value: str`

        DNA nucleotide sequence (A, C, G, T, N)

      - `cyclic: Optional[bool]`

        Whether the sequence is cyclic

      - `modifications: Optional[List[EntityDnaEntityModification]]`

        Chemical modifications. Optional; defaults to an empty list when omitted.

        - `class EntityDnaEntityModificationCcdModification: …`

          - `residue_index: int`

            0-based index of the residue to modify

          - `type: Literal["ccd"]`

            - `"ccd"`

          - `value: str`

            CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for phosphoserine)

        - `class EntityDnaEntityModificationSmilesModification: …`

          - `residue_index: int`

            0-based index of the residue to modify

          - `type: Literal["smiles"]`

            - `"smiles"`

          - `value: str`

            SMILES string for the modification

    - `class EntityLigandCcdEntity: …`

      - `chain_ids: List[str]`

        Chain IDs for this ligand

      - `type: Literal["ligand_ccd"]`

        - `"ligand_ccd"`

      - `value: str`

        CCD code (e.g., ATP, ADP)

    - `class EntityLigandSmilesEntity: …`

      - `chain_ids: List[str]`

        Chain IDs for this ligand

      - `type: Literal["ligand_smiles"]`

        - `"ligand_smiles"`

      - `value: str`

        SMILES string representing the ligand

  - `metrics: Metrics`

    Structural and binding quality metrics for a designed protein binder

    - `binding_confidence: float`

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

    - `helix_fraction: float`

      Fraction of the designed sequence forming alpha helices (0-1).

    - `iptm: float`

      Interface predicted TM score (0-1). Confidence in the protein-protein interface.

    - `loop_fraction: float`

      Fraction of the designed sequence in coil/loop regions (0-1).

    - `min_interaction_pae: float`

      Minimum predicted aligned error at the interface (Angstroms). Lower values indicate higher confidence.

    - `sheet_fraction: float`

      Fraction of the designed sequence forming beta sheets (0-1).

    - `structure_confidence: float`

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

  - `warnings: Optional[List[Warning]]`

    Warnings about potential quality issues with this result.

    - `code: str`

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

    - `message: str`

      Human-readable description of the warning

### Example

```python
import os
from boltz_api import Boltz

client = Boltz(
    api_key=os.environ.get("BOLTZ_API_KEY"),  # This is the default and can be omitted
)
page = client.protein.design.list_results(
    id="id",
)
page = page.data[0]
print(page.id)
```