## Text

`auto_scribe.reports.text(ReportTextParams**kwargs)  -> ReportTextResponse`

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

Retrieves the text content of a report. Can fetch a single report by report ID, or all reports for a study by study ID/DICOM UID. Returns plain text report content.

### Parameters

- `report_id: Optional[str]`

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

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

- `ReportTextResponse`

  Response containing a single report with its plain text

  - `class SingleReportTextResponse: …`

    Response containing a single report with its plain text

    - `report_id: str`

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

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

    - `study_id: str`

      Study ID this report belongs 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')

    - `plain_text: Optional[str]`

      Plain text content of the report

  - `class ListReportsTextResponse: …`

    Response containing a list of reports with their plain text

    - `reports: List[ListReportsTextResponseReport]`

      Array of report text items

      - `report_id: str`

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

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

      - `study_id: str`

        Study ID this report belongs 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')

      - `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
)
response = client.auto_scribe.reports.text()
print(response)
```