## Get redesigned protein sequences

`protein.sequence_redesign.list_results(strid, SequenceRedesignListResultsParams**kwargs)  -> SyncCursorPage[SequenceRedesignListResultsResponse]`

**get** `/compute/v1/protein/sequence-redesign/{id}/results`

Retrieve paginated results from a protein sequence redesign run

### Parameters

- `id: str`

- `after_id: Optional[str]`

  Return results after this ID

- `before_id: Optional[str]`

  Return results before this ID

- `ids: Optional[str]`

  Comma-separated list of result IDs to filter by (max 200). Only results whose ID matches one of these is returned; missing IDs are silently skipped. Composes with `limit`, `after_id`, and `before_id` — the filter is applied before pagination.

- `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

- `SequenceRedesignListResultsResponse`

  - `class BinderProteinDesignResult: …`

    - `id: str`

      Unique result ID.

    - `artifacts: BinderProteinDesignResultArtifacts`

      - `archive: BinderProteinDesignResultArtifactsArchive`

        - `url: str`

          URL to download the file

        - `url_expires_at: datetime`

          When the presigned URL expires

      - `structure: Optional[BinderProteinDesignResultArtifactsStructure]`

        - `url: str`

          URL to download the file

        - `url_expires_at: datetime`

          When the presigned URL expires

    - `created_at: datetime`

    - `entities: List[BinderProteinDesignResultEntity]`

      Entities in the designed complex, including designed and fixed input entities.

      - `class BinderProteinDesignResultEntityProteinEntity: …`

        - `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[BinderProteinDesignResultEntityProteinEntityModification]]`

          CCD post-translational modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported.

          - `residue_index: int`

            0-based index of the residue to modify

          - `type: Literal["ccd"]`

            Modification format. Only CCD polymer modifications are supported.

            - `"ccd"`

          - `value: str`

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

      - `class BinderProteinDesignResultEntityRnaEntity: …`

        - `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[BinderProteinDesignResultEntityRnaEntityModification]]`

          CCD chemical modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported.

          - `residue_index: int`

            0-based index of the residue to modify

          - `type: Literal["ccd"]`

            Modification format. Only CCD polymer modifications are supported.

            - `"ccd"`

          - `value: str`

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

      - `class BinderProteinDesignResultEntityDnaEntity: …`

        - `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[BinderProteinDesignResultEntityDnaEntityModification]]`

          CCD chemical modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported.

          - `residue_index: int`

            0-based index of the residue to modify

          - `type: Literal["ccd"]`

            Modification format. Only CCD polymer modifications are supported.

            - `"ccd"`

          - `value: str`

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

      - `class BinderProteinDesignResultEntityLigandCcdEntity: …`

        - `chain_ids: List[str]`

          Chain IDs for this ligand

        - `type: Literal["ligand_ccd"]`

          - `"ligand_ccd"`

        - `value: str`

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

      - `class BinderProteinDesignResultEntityLigandSmilesEntity: …`

        - `chain_ids: List[str]`

          Chain IDs for this ligand

        - `type: Literal["ligand_smiles"]`

          - `"ligand_smiles"`

        - `value: str`

          SMILES string representing the ligand

    - `metrics: BinderProteinDesignResultMetrics`

      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).

    - `type: Literal["binder"]`

      - `"binder"`

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

      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

  - `class GenericProteinDesignResult: …`

    - `id: str`

      Unique result ID.

    - `artifacts: GenericProteinDesignResultArtifacts`

      - `archive: GenericProteinDesignResultArtifactsArchive`

        - `url: str`

          URL to download the file

        - `url_expires_at: datetime`

          When the presigned URL expires

      - `structure: Optional[GenericProteinDesignResultArtifactsStructure]`

        - `url: str`

          URL to download the file

        - `url_expires_at: datetime`

          When the presigned URL expires

    - `created_at: datetime`

    - `entities: List[GenericProteinDesignResultEntity]`

      Entities in the designed complex, including designed and fixed input entities.

      - `class GenericProteinDesignResultEntityProteinEntity: …`

        - `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[GenericProteinDesignResultEntityProteinEntityModification]]`

          CCD post-translational modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported.

          - `residue_index: int`

            0-based index of the residue to modify

          - `type: Literal["ccd"]`

            Modification format. Only CCD polymer modifications are supported.

            - `"ccd"`

          - `value: str`

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

      - `class GenericProteinDesignResultEntityRnaEntity: …`

        - `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[GenericProteinDesignResultEntityRnaEntityModification]]`

          CCD chemical modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported.

          - `residue_index: int`

            0-based index of the residue to modify

          - `type: Literal["ccd"]`

            Modification format. Only CCD polymer modifications are supported.

            - `"ccd"`

          - `value: str`

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

      - `class GenericProteinDesignResultEntityDnaEntity: …`

        - `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[GenericProteinDesignResultEntityDnaEntityModification]]`

          CCD chemical modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported.

          - `residue_index: int`

            0-based index of the residue to modify

          - `type: Literal["ccd"]`

            Modification format. Only CCD polymer modifications are supported.

            - `"ccd"`

          - `value: str`

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

      - `class GenericProteinDesignResultEntityLigandCcdEntity: …`

        - `chain_ids: List[str]`

          Chain IDs for this ligand

        - `type: Literal["ligand_ccd"]`

          - `"ligand_ccd"`

        - `value: str`

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

      - `class GenericProteinDesignResultEntityLigandSmilesEntity: …`

        - `chain_ids: List[str]`

          Chain IDs for this ligand

        - `type: Literal["ligand_smiles"]`

          - `"ligand_smiles"`

        - `value: str`

          SMILES string representing the ligand

    - `metrics: GenericProteinDesignResultMetrics`

      Structure and design-quality metrics for a generic protein design.

      - `helix_fraction: float`

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

      - `loop_fraction: float`

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

      - `sheet_fraction: float`

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

      - `structure_confidence: float`

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

    - `type: Literal["generic"]`

      - `"generic"`

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

      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.sequence_redesign.list_results(
    id="id",
)
page = page.data[0]
print(page)
```

#### Response

```json
{
  "data": [
    {
      "id": "id",
      "artifacts": {
        "archive": {
          "url": "https://example.com",
          "url_expires_at": "2019-12-27T18:11:19.117Z"
        },
        "structure": {
          "url": "https://example.com",
          "url_expires_at": "2019-12-27T18:11:19.117Z"
        }
      },
      "created_at": "2019-12-27T18:11:19.117Z",
      "entities": [
        {
          "chain_ids": [
            "string"
          ],
          "type": "protein",
          "value": "value",
          "cyclic": true,
          "modifications": [
            {
              "residue_index": 0,
              "type": "ccd",
              "value": "value"
            }
          ]
        }
      ],
      "metrics": {
        "binding_confidence": 0,
        "helix_fraction": 0,
        "iptm": 0,
        "loop_fraction": 0,
        "min_interaction_pae": 0,
        "sheet_fraction": 0,
        "structure_confidence": 0
      },
      "type": "binder",
      "warnings": [
        {
          "code": "code",
          "message": "message"
        }
      ]
    }
  ],
  "first_id": "first_id",
  "has_more": true,
  "last_id": "last_id"
}
```