## List

`StudyListPageResponse Viewer.Studies.List(StudyListParams?parameters, CancellationTokencancellationToken = default)`

**get** `/v1/viewer/studies`

Retrieves a paginated list of studies with optional filtering by assignment, severity, description, cancellation status, and viewer status. Returns up to 100 studies per request.

### Parameters

- `StudyListParams parameters`

  - `string? assignedTo`

    Filter by assigned user ID (null = explicitly unassigned). Format: usr_<32-hex-chars>

  - `string cursor`

    Base64 encoded cursor from previous response

  - `string? expressCustomerID`

    Filter by Express customer ID (null = studies with no customer). Format: cus_{32-hex-chars}

  - `Boolean? isCancelled`

    Filter by cancellation status

  - `Double limit`

    Number of results to return (1-100)

  - `Severity severity`

    Filter by study severity

    - `"normal"Normal`

    - `"high"High`

    - `"stat"Stat`

  - `string studyDescription`

    Filter by study description (contains match)

  - `StudyViewerStatus studyViewerStatus`

    Filter by study viewer status

    - `"incomplete"Incomplete`

    - `"complete"Complete`

### Returns

- `class StudyListPageResponse:`

  Paginated list of Viewer studies

  - `required Boolean HasMore`

  - `required IReadOnlyList<StudyListResponse> Studies`

    - `required DateTimeOffset? CancelledAt`

      Timestamp when the study was cancelled, null if not cancelled

    - `required DateTimeOffset? CreatedAt`

      Timestamp when the study was created

    - `required Boolean IsCancelled`

      Whether the study has been cancelled

    - `required Severity Severity`

      Priority level of the study. 'normal' for routine, 'high' for urgent, 'stat' for immediate attention

      - `"normal"Normal`

      - `"high"High`

      - `"stat"Stat`

    - `required string StudyDescription`

      Description of the study/scan (e.g., 'Brain MRI with Contrast', 'Chest CT')

    - `required string StudyID`

      Unique study identifier. Format: stu_{32-hex-chars}

    - `required string StudyInstanceUid`

      DICOM Study Instance UID. Must be a valid DICOM UID format (e.g., '1.2.840.10008.5.1.4.1.1.2')

    - `required StudyViewerStatus StudyViewerStatus`

      - `"incomplete"Incomplete`

      - `"complete"Complete`

    - `required DateTimeOffset? UpdatedAt`

      Timestamp when the study was last updated

    - `UserReference? AssignedTo`

      A reference to a user with basic identifying information

      - `required string Email`

        User's email address

      - `required string UserID`

        Unique user identifier. Format: usr_{32-hex-chars}

      - `string FirstName`

        User's first name

      - `string LastName`

        User's last name

      - `string MiddleName`

        User's middle name

      - `string Suffix1`

        Name suffix (e.g., 'MD', 'Jr.')

      - `string Suffix2`

        Additional name suffix

    - `ApiKeyReference? CreatedByApiKey`

      A reference to an API key with basic identifying information

      - `required string ApiKeyID`

        Unique API key identifier (UUIDv4 format)

      - `required string Description`

        Human-readable description of the API key

      - `Boolean IsViewerEnabled`

        Whether this API key has access to the Viewer product

    - `UserReference? CreatedByUser`

      A reference to a user with basic identifying information

      - `required string Email`

        User's email address

      - `required string UserID`

        Unique user identifier. Format: usr_{32-hex-chars}

      - `string FirstName`

        User's first name

      - `string LastName`

        User's last name

      - `string MiddleName`

        User's middle name

      - `string Suffix1`

        Name suffix (e.g., 'MD', 'Jr.')

      - `string Suffix2`

        Additional name suffix

    - `ExpressCustomerReference? ExpressCustomer`

      A reference to an Express customer with basic identifying information

      - `required string ExpressCustomerID`

        Unique Express customer identifier. Format: cus_{32-hex-chars}

      - `required string ExpressCustomerName`

        Name of the Express customer

    - `IReadOnlyDictionary<string, string> Metadata`

      Custom key-value metadata for the study. Maximum 50 pairs, keys up to 100 chars, values up to 1000 chars

  - `string Cursor`

### Example

```csharp
StudyListParams parameters = new();

var page = await client.Viewer.Studies.List(parameters);
await foreach (var item in page.Paginate())
{
    Console.WriteLine(item);
}
```