## List

`protein.library_screen.list(LibraryScreenListParams**kwargs)  -> SyncCursorPage[LibraryScreenListResponse]`

**get** `/compute/v1/protein/library-screen`

List protein library screens, optionally filtered by workspace

### Parameters

- `after_id: Optional[str]`

  Return results after this ID

- `before_id: Optional[str]`

  Return results before this ID

- `limit: Optional[int]`

  Max items to return. Defaults to 100.

- `workspace_id: Optional[str]`

  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

- `class LibraryScreenListResponse: …`

  Summary of a protein library screening engine run (excludes input)

  - `id: str`

    Unique ProteinLibraryScreenSummary identifier

  - `completed_at: Optional[datetime]`

  - `created_at: datetime`

  - `data_deleted_at: Optional[datetime]`

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

  - `engine: Literal["boltz-protein-screen"]`

    Engine used for protein library screen

    - `"boltz-protein-screen"`

  - `engine_version: str`

    Engine version used for protein library screen

  - `error: Optional[Error]`

    - `code: str`

      Machine-readable error code

    - `message: str`

      Human-readable error message

    - `details: Optional[object]`

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

  - `livemode: bool`

    Whether this resource was created with a live API key.

  - `progress: Optional[Progress]`

    - `num_proteins_failed: int`

      Number of accepted proteins that reached terminal failure during screening.

    - `num_proteins_screened: int`

      Number of accepted proteins that produced usable screening results.

    - `total_proteins_to_screen: int`

      Total number of proteins accepted into the screening run.

    - `latest_result_id: Optional[str]`

      ID of the latest result

  - `started_at: Optional[datetime]`

  - `status: Literal["pending", "running", "succeeded", 2 more]`

    - `"pending"`

    - `"running"`

    - `"succeeded"`

    - `"failed"`

    - `"stopped"`

  - `stopped_at: Optional[datetime]`

  - `workspace_id: str`

    Workspace ID

  - `idempotency_key: Optional[str]`

    Client-provided idempotency key

### 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.library_screen.list()
page = page.data[0]
print(page.id)
```