Reports

List reports for a study

GET/v1/autoScribe/reports

Retrieve report text

GET/v1/autoScribe/reports/text

Retrieve report PDF URL

GET/v1/autoScribe/reports/pdf

Create a report addendum

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

Cancel a report addendum

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

ModelsExpand Collapse

Report = object { createdAt, isAddendum, isCritical, 8 more }

A radiology report in the AutoScribe system

createdAt: string

Timestamp when the report was created

formatdate-time

isAddendum: boolean

Whether this report is an addendum to a previous report

isCritical: boolean

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

reportId: string

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

signedAt: string

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

formatdate-time

snapshotMetadata: StudyReportMetadata { age, dateOfBirth, facilityName, 9 more }

Patient demographics and scan information for report generation

age: optional string

Patient's age at study date (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: HeightUnit

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

Accepts one of the following:

"in"

"cm"

value: number

minimum0

mrn: optional string

Medical Record Number - unique patient identifier

patientName: optional string

Full name of the patient

procedure: optional string

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

referringPhysicianName: optional string

Name of the physician who referred the patient for this scan

sex: optional Sex

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

Accepts one of the following:

"male"

"female"

"other"

studyDate: optional string

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

studyTime: optional string

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

weight: optional object { unit, value }

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

unit: WeightUnit

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

Accepts one of the following:

"lbs"

"kg"

value: number

minimum0

status: ReportStatus

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

Accepts one of the following:

"in_progress"

"completed"

studyId: string

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

updatedAt: string

Timestamp when the report was last updated

formatdate-time

userId: string

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

reportPlainText: optional string

Plain text content of the report

ReportPdfItem = object { isCritical, presignedUrl, reportId, 3 more }

A report with its PDF download URL

isCritical: boolean

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

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 { age, dateOfBirth, facilityName, 9 more }

Patient demographics and scan information for report generation

age: optional string

Patient's age at study date (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: HeightUnit

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

Accepts one of the following:

"in"

"cm"

value: number

minimum0

mrn: optional string

Medical Record Number - unique patient identifier

patientName: optional string

Full name of the patient

procedure: optional string

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

referringPhysicianName: optional string

Name of the physician who referred the patient for this scan

sex: optional Sex

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

Accepts one of the following:

"male"

"female"

"other"

studyDate: optional string

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

studyTime: optional string

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

weight: optional object { unit, value }

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

unit: WeightUnit

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

Accepts one of the following:

"lbs"

"kg"

value: number

minimum0

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

minLength1

ReportTextItem = object { isCritical, reportId, snapshotMetadata, 3 more }

A report with its plain text content

isCritical: boolean

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

reportId: string

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

snapshotMetadata: StudyReportMetadata { age, dateOfBirth, facilityName, 9 more }

Patient demographics and scan information for report generation

age: optional string

Patient's age at study date (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: HeightUnit

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

Accepts one of the following:

"in"

"cm"

value: number

minimum0

mrn: optional string

Medical Record Number - unique patient identifier

patientName: optional string

Full name of the patient

procedure: optional string

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

referringPhysicianName: optional string

Name of the physician who referred the patient for this scan

sex: optional Sex

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

Accepts one of the following:

"male"

"female"

"other"

studyDate: optional string

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

studyTime: optional string

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

weight: optional object { unit, value }

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

unit: WeightUnit

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

Accepts one of the following:

"lbs"

"kg"

value: number

minimum0

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

minLength1

plainText: optional string

Plain text content of the report