## Pdf

`auto_scribe.reports.pdf(ReportPdfParams**kwargs)  -> ReportPdfResponse`

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

Retrieves presigned URLs for accessing report PDFs. Can fetch a single report by report ID, or all reports for a study by study ID/DICOM UID. URLs are time-limited for security.

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

- `ReportPdfResponse`

  Response containing a single report with its PDF download URL

  - `class SingleReportPdfResponse: …`

    Response containing a single report with its PDF download URL

    - `presigned_url: str`

      Time-limited presigned URL to download the PDF (expires after 1 hour)

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

  - `class ListReportsPdfResponse: …`

    Response containing a list of reports with their PDF download URLs

    - `reports: List[ListReportsPdfResponseReport]`

      Array of report PDF items with download URLs

      - `presigned_url: str`

        Time-limited presigned URL to download the PDF (expires after 1 hour)

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

    - `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.pdf()
print(response)
```