## List

`auto_scribe.reports.list(ReportListParams**kwargs)  -> ReportListResponse`

**get** `/v1/autoScribe/reports`

Retrieves all reports (including versions and addendums) for a specific study. Must provide either study ID or DICOM Study Instance UID. Returns report metadata including status, version, and timestamps.

### Parameters

- `study_id: Optional[str]`

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

- `study_instance_uid: Optional[str]`

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

### Returns

- `class ReportListResponse: …`

  Response containing a list of reports for a study

  - `reports: List[Report]`

    Array of report objects with full details

    - `created_at: Optional[datetime]`

      Timestamp when the report was created

    - `is_addendum: bool`

      Whether this report is an addendum to a previous report

    - `report_id: str`

      Unique report identifier. Format: rep_{32-hex-chars}

    - `signed_at: Optional[datetime]`

      Timestamp when the report was signed, null if not yet signed

    - `snapshot_metadata: StudyReportMetadata`

      Patient demographics and scan information for report generation

      - `age: Optional[str]`

        Patient's age at time of scan (e.g., '34.5 years', '2 months')

      - `date_of_birth: Optional[str]`

        Patient's date of birth. Format: YYYY-MM-DD (e.g., '1990-05-20')

      - `facility_name: Optional[str]`

        Name of the medical facility where the scan was performed

      - `height: Optional[Height]`

        Patient's height with unit (e.g., {value: 70, unit: 'inches'} or {value: 178, unit: 'cm'})

        - `unit: Literal["in", "cm"]`

          - `"in"`

          - `"cm"`

        - `value: float`

      - `mrn: Optional[str]`

        Medical Record Number - unique patient identifier

      - `patient_name: Optional[str]`

        Full name of the patient

      - `referring_physician_name: Optional[str]`

        Name of the physician who referred the patient for this scan

      - `scan_date: Optional[str]`

        Date the scan was performed. Format: YYYY-MM-DD (e.g., '2024-01-15')

      - `scan_time: Optional[str]`

        Time the scan was performed. Format: HH:MM (e.g., '14:30')

      - `scan_type: Optional[str]`

        Type of scan or imaging modality (e.g., 'MRI', 'CT', 'X-Ray', 'Ultrasound')

      - `sex: Optional[Literal["male", "female", "other"]]`

        Patient's biological sex. Options: 'male', 'female', 'other'

        - `"male"`

        - `"female"`

        - `"other"`

      - `weight: Optional[Weight]`

        Patient's weight with unit (e.g., {value: 150, unit: 'lbs'} or {value: 68, unit: 'kg'})

        - `unit: Literal["lbs", "kg"]`

          - `"lbs"`

          - `"kg"`

        - `value: float`

    - `status: Literal["in_progress", "completed"]`

      Report status: 'in_progress' or 'completed'

      - `"in_progress"`

      - `"completed"`

    - `study_id: str`

      Study ID this report belongs to. Format: stu_{32-hex-chars}

    - `updated_at: Optional[datetime]`

      Timestamp when the report was last updated

    - `user_id: str`

      User ID of the radiologist who created/signed this report. Format: usr_{32-hex-chars}

    - `report_plain_text: Optional[str]`

      Plain text content of the report

  - `study_id: str`

    Study ID the reports belong to. Format: stu_{32-hex-chars}

  - `study_instance_uid: str`

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

### Example

```python
import os
from avara import Avara

client = Avara(
    api_key=os.environ.get("AVARA_API_KEY"),  # This is the default and can be omitted
)
reports = client.auto_scribe.reports.list()
print(reports.study_instance_uid)
```