Reports

List reports for a study

ReportListResponse autoScribe().reports().list(, )

GET/v1/autoScribe/reports

Retrieve report text

ReportTextResponse autoScribe().reports().text(, )

GET/v1/autoScribe/reports/text

Retrieve report PDF URL

ReportPdfResponse autoScribe().reports().pdf(, )

GET/v1/autoScribe/reports/pdf

Create a report addendum

ReportAddendumResponse autoScribe().reports().addendum(, )

POST/v1/autoScribe/reports/{reportId}/addendum

Cancel a report addendum

ReportCancelAddendumResponse autoScribe().reports().cancelAddendum(, )

POST/v1/autoScribe/reports/{reportId}/cancel-addendum

ModelsExpand Collapse

class Report:

A radiology report in the AutoScribe system

Optional<LocalDateTime> createdAt

Timestamp when the report was created

formatdate-time

boolean isAddendum

Whether this report is an addendum to a previous report

Optional<Boolean> isCritical

Whether the report was marked critical at sign-off. null when the report is not yet completed; true/false once completed.

String reportId

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

Optional<LocalDateTime> signedAt

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

formatdate-time

StudyReportMetadata snapshotMetadata

Patient demographics and scan information for report generation

Optional<String> age

Patient’s age at study date (e.g., ‘34.5 years’, ‘2 months’)

Optional<String> dateOfBirth

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

Optional<String> facilityName

Name of the medical facility where the scan was performed

Optional<Height> height

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

HeightUnit unit

Unit of measure for a height value. ‘in’ = inches, ‘cm’ = centimeters.

One of the following:

IN("in")

CM("cm")

double value

minimum0

Optional<String> mrn

Medical Record Number - unique patient identifier

Optional<String> patientName

Full name of the patient

Optional<String> procedure

Procedure or study type (e.g., ‘MRI Brain with Contrast’). Maps to database scan_type and dictation report_header.scan_type.

Optional<String> referringPhysicianName

Name of the physician who referred the patient for this scan

Optional<Sex> sex

Patient’s biological sex. Options: ‘male’, ‘female’, ‘other’

One of the following:

MALE("male")

FEMALE("female")

OTHER("other")

Optional<String> studyDate

Study date (YYYY-MM-DD). Maps to database scan_date and dictation report_header.scan_date.

Optional<String> studyTime

Study time (HH:MM). Maps to database scan_time and dictation report_header.scan_time.

Optional<Weight> weight

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

WeightUnit unit

Unit of measure for a weight value. ‘lbs’ = pounds, ‘kg’ = kilograms.

One of the following:

LBS("lbs")

KG("kg")

double value

minimum0

ReportStatus status

Status of an individual report. ‘in_progress’ = actively being dictated, ‘completed’ = signed.

One of the following:

IN_PROGRESS("in_progress")

COMPLETED("completed")

String studyId

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

Optional<LocalDateTime> updatedAt

Timestamp when the report was last updated

formatdate-time

String userId

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

Optional<String> reportPlainText

Plain text content of the report

class ReportPdfItem:

A report with its PDF download URL

Optional<Boolean> isCritical

Whether the report was marked critical at sign-off. null when the report is not yet completed; true/false once completed.

String presignedUrl

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

String reportId

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

StudyReportMetadata snapshotMetadata

Patient demographics and scan information for report generation

Optional<String> age

Patient’s age at study date (e.g., ‘34.5 years’, ‘2 months’)

Optional<String> dateOfBirth

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

Optional<String> facilityName

Name of the medical facility where the scan was performed

Optional<Height> height

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

HeightUnit unit

Unit of measure for a height value. ‘in’ = inches, ‘cm’ = centimeters.

One of the following:

IN("in")

CM("cm")

double value

minimum0

Optional<String> mrn

Medical Record Number - unique patient identifier

Optional<String> patientName

Full name of the patient

Optional<String> procedure

Procedure or study type (e.g., ‘MRI Brain with Contrast’). Maps to database scan_type and dictation report_header.scan_type.

Optional<String> referringPhysicianName

Name of the physician who referred the patient for this scan

Optional<Sex> sex

Patient’s biological sex. Options: ‘male’, ‘female’, ‘other’

One of the following:

MALE("male")

FEMALE("female")

OTHER("other")

Optional<String> studyDate

Study date (YYYY-MM-DD). Maps to database scan_date and dictation report_header.scan_date.

Optional<String> studyTime

Study time (HH:MM). Maps to database scan_time and dictation report_header.scan_time.

Optional<Weight> weight

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

WeightUnit unit

Unit of measure for a weight value. ‘lbs’ = pounds, ‘kg’ = kilograms.

One of the following:

LBS("lbs")

KG("kg")

double value

minimum0

String studyId

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

String studyInstanceUid

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

minLength1

class ReportTextItem:

A report with its plain text content

Optional<Boolean> isCritical

Whether the report was marked critical at sign-off. null when the report is not yet completed; true/false once completed.

String reportId

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

StudyReportMetadata snapshotMetadata

Patient demographics and scan information for report generation

Optional<String> age

Patient’s age at study date (e.g., ‘34.5 years’, ‘2 months’)

Optional<String> dateOfBirth

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

Optional<String> facilityName

Name of the medical facility where the scan was performed

Optional<Height> height

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

HeightUnit unit

Unit of measure for a height value. ‘in’ = inches, ‘cm’ = centimeters.

One of the following:

IN("in")

CM("cm")

double value

minimum0

Optional<String> mrn

Medical Record Number - unique patient identifier

Optional<String> patientName

Full name of the patient

Optional<String> procedure

Procedure or study type (e.g., ‘MRI Brain with Contrast’). Maps to database scan_type and dictation report_header.scan_type.

Optional<String> referringPhysicianName

Name of the physician who referred the patient for this scan

Optional<Sex> sex

Patient’s biological sex. Options: ‘male’, ‘female’, ‘other’

One of the following:

MALE("male")

FEMALE("female")

OTHER("other")

Optional<String> studyDate

Study date (YYYY-MM-DD). Maps to database scan_date and dictation report_header.scan_date.

Optional<String> studyTime

Study time (HH:MM). Maps to database scan_time and dictation report_header.scan_time.

Optional<Weight> weight

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

WeightUnit unit

Unit of measure for a weight value. ‘lbs’ = pounds, ‘kg’ = kilograms.

One of the following:

LBS("lbs")

KG("kg")

double value

minimum0

String studyId

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

String studyInstanceUid

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

minLength1

Optional<String> plainText

Plain text content of the report