## Pdf

**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.

### Query Parameters

- `reportId: optional string`

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

- `studyId: optional string`

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

- `studyInstanceUid: optional string`

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

### Returns

- `SingleReportPdfResponse = object { presignedUrl, reportId, snapshotMetadata, 2 more }`

  Response containing a single report with its PDF download URL

  - `presignedUrl: string`

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

  - `reportId: string`

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

  - `snapshotMetadata: StudyReportMetadata`

    Patient demographics and scan information for report generation

    - `age: optional string`

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

    - `dateOfBirth: optional string`

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

    - `facilityName: optional string`

      Name of the medical facility where the scan was performed

    - `height: optional object { unit, value }`

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

      - `unit: "in" or "cm"`

        - `"in"`

        - `"cm"`

      - `value: number`

    - `mrn: optional string`

      Medical Record Number - unique patient identifier

    - `patientName: optional string`

      Full name of the patient

    - `referringPhysicianName: optional string`

      Name of the physician who referred the patient for this scan

    - `scanDate: optional string`

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

    - `scanTime: optional string`

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

    - `scanType: optional string`

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

    - `sex: optional "male" or "female" or "other"`

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

      - `"male"`

      - `"female"`

      - `"other"`

    - `weight: optional object { unit, value }`

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

      - `unit: "lbs" or "kg"`

        - `"lbs"`

        - `"kg"`

      - `value: number`

  - `studyId: string`

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

  - `studyInstanceUid: string`

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

- `ListReportsPdfResponse = object { reports, studyId, studyInstanceUid }`

  Response containing a list of reports with their PDF download URLs

  - `reports: array of object { presignedUrl, reportId, snapshotMetadata, 2 more }`

    Array of report PDF items with download URLs

    - `presignedUrl: string`

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

    - `reportId: string`

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

    - `snapshotMetadata: StudyReportMetadata`

      Patient demographics and scan information for report generation

      - `age: optional string`

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

      - `dateOfBirth: optional string`

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

      - `facilityName: optional string`

        Name of the medical facility where the scan was performed

      - `height: optional object { unit, value }`

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

        - `unit: "in" or "cm"`

          - `"in"`

          - `"cm"`

        - `value: number`

      - `mrn: optional string`

        Medical Record Number - unique patient identifier

      - `patientName: optional string`

        Full name of the patient

      - `referringPhysicianName: optional string`

        Name of the physician who referred the patient for this scan

      - `scanDate: optional string`

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

      - `scanTime: optional string`

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

      - `scanType: optional string`

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

      - `sex: optional "male" or "female" or "other"`

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

        - `"male"`

        - `"female"`

        - `"other"`

      - `weight: optional object { unit, value }`

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

        - `unit: "lbs" or "kg"`

          - `"lbs"`

          - `"kg"`

        - `value: number`

    - `studyId: string`

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

    - `studyInstanceUid: string`

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

  - `studyId: string`

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

  - `studyInstanceUid: string`

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

### Example

```http
curl https://api.avarasoftware.com/v1/autoScribe/reports/pdf \
    -H "Authorization: Bearer $AVARA_API_KEY"
```