## Get redesigned protein sequences `$ boltz-api protein:sequence-redesign list-results` **get** `/compute/v1/protein/sequence-redesign/{id}/results` Retrieve paginated results from a protein sequence redesign run ### Parameters - `--id: string` Sequence redesign run ID - `--after-id: optional string` Return results after this ID - `--before-id: optional string` Return results before this ID - `--ids: optional string` 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 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 - `ProteinSequenceRedesignResultsResponse: object { data, first_id, has_more, last_id }` - `data: array of object { id, artifacts, created_at, 4 more } or object { id, artifacts, created_at, 4 more }` - `BinderProteinDesignResult: object { id, artifacts, created_at, 4 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: optional object { url, url_expires_at }` - `url: string` URL to download the file - `url_expires_at: string` When the presigned URL expires - `created_at: string` - `entities: array of object { chain_ids, type, value, 2 more } or object { chain_ids, type, value, 2 more } or object { chain_ids, type, value, 2 more } or 2 more` Entities in the designed complex, including designed and fixed input entities. - `ProteinEntity: object { chain_ids, type, value, 2 more }` - `chain_ids: array of string` Chain IDs for this entity - `type: "protein"` - `value: string` Amino acid sequence (one-letter codes) - `cyclic: optional boolean` Whether the sequence is cyclic - `modifications: optional array of object { residue_index, type, value }` CCD post-translational modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported. - `residue_index: number` 0-based index of the residue to modify - `type: "ccd"` Modification format. Only CCD polymer modifications are supported. - `value: string` CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for phosphoserine) - `RNAEntity: object { chain_ids, type, value, 2 more }` - `chain_ids: array of string` Chain IDs for this entity - `type: "rna"` - `value: string` RNA nucleotide sequence (A, C, G, U, N) - `cyclic: optional boolean` Whether the sequence is cyclic - `modifications: optional array of object { residue_index, type, value }` CCD chemical modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported. - `residue_index: number` 0-based index of the residue to modify - `type: "ccd"` Modification format. Only CCD polymer modifications are supported. - `value: string` CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for phosphoserine) - `DNAEntity: object { chain_ids, type, value, 2 more }` - `chain_ids: array of string` Chain IDs for this entity - `type: "dna"` - `value: string` DNA nucleotide sequence (A, C, G, T, N) - `cyclic: optional boolean` Whether the sequence is cyclic - `modifications: optional array of object { residue_index, type, value }` CCD chemical modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported. - `residue_index: number` 0-based index of the residue to modify - `type: "ccd"` Modification format. Only CCD polymer modifications are supported. - `value: string` CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for phosphoserine) - `LigandCCDEntity: object { chain_ids, type, value }` - `chain_ids: array of string` Chain IDs for this ligand - `type: "ligand_ccd"` - `value: string` CCD code (e.g., ATP, ADP) - `LigandSmilesEntity: object { chain_ids, type, value }` - `chain_ids: array of string` Chain IDs for this ligand - `type: "ligand_smiles"` - `value: string` SMILES string representing the ligand - `metrics: object { binding_confidence, helix_fraction, iptm, 4 more }` Structural and binding quality metrics for a designed protein binder - `binding_confidence: number` Confidence that the designed binder binds the target (0-1). Primary metric for hit discovery. - `helix_fraction: number` Fraction of the designed sequence forming alpha helices (0-1). - `iptm: number` Interface predicted TM score (0-1). Confidence in the protein-protein interface. - `loop_fraction: number` Fraction of the designed sequence in coil/loop regions (0-1). - `min_interaction_pae: number` Minimum predicted aligned error at the interface (Angstroms). Lower values indicate higher confidence. - `sheet_fraction: number` Fraction of the designed sequence forming beta sheets (0-1). - `structure_confidence: number` Confidence in the predicted 3D structure (0-1). - `type: "binder"` - `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 - `GenericProteinDesignResult: object { id, artifacts, created_at, 4 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: optional object { url, url_expires_at }` - `url: string` URL to download the file - `url_expires_at: string` When the presigned URL expires - `created_at: string` - `entities: array of object { chain_ids, type, value, 2 more } or object { chain_ids, type, value, 2 more } or object { chain_ids, type, value, 2 more } or 2 more` Entities in the designed complex, including designed and fixed input entities. - `ProteinEntity: object { chain_ids, type, value, 2 more }` - `chain_ids: array of string` Chain IDs for this entity - `type: "protein"` - `value: string` Amino acid sequence (one-letter codes) - `cyclic: optional boolean` Whether the sequence is cyclic - `modifications: optional array of object { residue_index, type, value }` CCD post-translational modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported. - `residue_index: number` 0-based index of the residue to modify - `type: "ccd"` Modification format. Only CCD polymer modifications are supported. - `value: string` CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for phosphoserine) - `RNAEntity: object { chain_ids, type, value, 2 more }` - `chain_ids: array of string` Chain IDs for this entity - `type: "rna"` - `value: string` RNA nucleotide sequence (A, C, G, U, N) - `cyclic: optional boolean` Whether the sequence is cyclic - `modifications: optional array of object { residue_index, type, value }` CCD chemical modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported. - `residue_index: number` 0-based index of the residue to modify - `type: "ccd"` Modification format. Only CCD polymer modifications are supported. - `value: string` CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for phosphoserine) - `DNAEntity: object { chain_ids, type, value, 2 more }` - `chain_ids: array of string` Chain IDs for this entity - `type: "dna"` - `value: string` DNA nucleotide sequence (A, C, G, T, N) - `cyclic: optional boolean` Whether the sequence is cyclic - `modifications: optional array of object { residue_index, type, value }` CCD chemical modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported. - `residue_index: number` 0-based index of the residue to modify - `type: "ccd"` Modification format. Only CCD polymer modifications are supported. - `value: string` CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for phosphoserine) - `LigandCCDEntity: object { chain_ids, type, value }` - `chain_ids: array of string` Chain IDs for this ligand - `type: "ligand_ccd"` - `value: string` CCD code (e.g., ATP, ADP) - `LigandSmilesEntity: object { chain_ids, type, value }` - `chain_ids: array of string` Chain IDs for this ligand - `type: "ligand_smiles"` - `value: string` SMILES string representing the ligand - `metrics: object { helix_fraction, loop_fraction, sheet_fraction, structure_confidence }` Structure and design-quality metrics for a generic protein design. - `helix_fraction: number` Fraction of the designed sequence forming alpha helices (0-1). - `loop_fraction: number` Fraction of the designed sequence in coil/loop regions (0-1). - `sheet_fraction: number` Fraction of the designed sequence forming beta sheets (0-1). - `structure_confidence: number` Confidence in the predicted 3D structure (0-1). - `type: "generic"` - `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 protein:sequence-redesign list-results \ --api-key 'My API Key' \ --id id ``` #### 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" } ```