Retrieve report text

auto_scribe.reports.text() -> 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.

ParametersExpand Collapse

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

ReturnsExpand Collapse

ReportTextResponse

Response containing a single report with its plain text

Accepts one of the following:

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"]

Accepts one of the following:

"in"

"cm"

value: float

minimum0

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'

Accepts one of the following:

"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"]

Accepts one of the following:

"lbs"

"kg"

value: float

minimum0

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

minLength1

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"]

Accepts one of the following:

"in"

"cm"

value: float

minimum0

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'

Accepts one of the following:

"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"]

Accepts one of the following:

"lbs"

"kg"

value: float

minimum0

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

minLength1

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

minLength1

Retrieve report text

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)

{
  "reportId": "rep_1234567890abcdef1234567890abcdef",
  "snapshotMetadata": {
    "age": "38 years",
    "dateOfBirth": "1985-07-20",
    "facilityName": "City Medical Center",
    "height": {
      "unit": "cm",
      "value": 165
    },
    "mrn": "MRN-2024-001234",
    "patientName": "Jane Doe",
    "referringPhysicianName": "Dr. Michael Chen",
    "scanDate": "2024-03-15",
    "scanTime": "14:30",
    "scanType": "MRI Brain with Contrast",
    "sex": "female",
    "weight": {
      "unit": "kg",
      "value": 62
    }
  },
  "studyId": "stu_1234567890abcdef1234567890abcdef",
  "studyInstanceUid": "1.2.840.113619.2.55.3.604688119.868.1234567890.123",
  "plainText": "FINDINGS: Normal brain MRI. No acute intracranial abnormality. IMPRESSION: Unremarkable brain MRI."
}

Returns Examples

{
  "reportId": "rep_1234567890abcdef1234567890abcdef",
  "snapshotMetadata": {
    "age": "38 years",
    "dateOfBirth": "1985-07-20",
    "facilityName": "City Medical Center",
    "height": {
      "unit": "cm",
      "value": 165
    },
    "mrn": "MRN-2024-001234",
    "patientName": "Jane Doe",
    "referringPhysicianName": "Dr. Michael Chen",
    "scanDate": "2024-03-15",
    "scanTime": "14:30",
    "scanType": "MRI Brain with Contrast",
    "sex": "female",
    "weight": {
      "unit": "kg",
      "value": 62
    }
  },
  "studyId": "stu_1234567890abcdef1234567890abcdef",
  "studyInstanceUid": "1.2.840.113619.2.55.3.604688119.868.1234567890.123",
  "plainText": "FINDINGS: Normal brain MRI. No acute intracranial abnormality. IMPRESSION: Unremarkable brain MRI."
}