## Retrieve By Uid

**get** `/v1/autoScribe/studies/by-uid/{studyInstanceUid}`

Retrieves a single study by its DICOM Study Instance UID. This is useful when you have the DICOM UID but not the Avara study ID.

### Path Parameters

- `studyInstanceUid: string`

  DICOM Study Instance UID. Format: numbers and dots (e.g., 1.2.840.10008.5.1.4.1.1.2).

### Returns

- `cancelledAt: string`

  Timestamp when the study was cancelled, null if not cancelled

- `createdAt: string`

  Timestamp when the study was created

- `isCancelled: boolean`

  Whether the study has been cancelled

- `reportMetadata: 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`

- `severity: "normal" or "high" or "stat"`

  Priority level of the study. 'normal' for routine, 'high' for urgent, 'stat' for immediate attention

  - `"normal"`

  - `"high"`

  - `"stat"`

- `studyDescription: string`

  Description of the study/scan (e.g., 'Brain MRI with Contrast', 'Chest CT')

- `studyId: string`

  Unique study identifier. 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')

- `studyReportStatus: "unassigned" or "assigned" or "in_progress" or 2 more`

  Report workflow status. 'unassigned' = no radiologist assigned, 'assigned' = assigned but not started, 'in_progress' = actively being dictated, 'completed' = report signed, 'addendum_active' = addendum in progress

  - `"unassigned"`

  - `"assigned"`

  - `"in_progress"`

  - `"completed"`

  - `"addendum_active"`

- `updatedAt: string`

  Timestamp when the study was last updated

- `assignedTo: optional object { email, userId, firstName, 4 more }`

  Reference to the assigned radiologist, null if unassigned

  - `email: string`

    User's email address

  - `userId: string`

    Unique user identifier. Format: usr_{32-hex-chars}

  - `firstName: optional string`

    User's first name

  - `lastName: optional string`

    User's last name

  - `middleName: optional string`

    User's middle name

  - `suffix1: optional string`

    Name suffix (e.g., 'MD', 'Jr.')

  - `suffix2: optional string`

    Additional name suffix

- `createdByApiKey: optional object { apiKeyId, description, isViewerEnabled }`

  Reference to the API key used to create this study

  - `apiKeyId: string`

    Unique API key identifier (UUIDv4 format)

  - `description: string`

    Human-readable description of the API key

  - `isViewerEnabled: optional boolean`

    Whether this API key has access to the Viewer product

- `createdByUser: optional object { email, userId, firstName, 4 more }`

  Reference to the user who created this study via dashboard

  - `email: string`

    User's email address

  - `userId: string`

    Unique user identifier. Format: usr_{32-hex-chars}

  - `firstName: optional string`

    User's first name

  - `lastName: optional string`

    User's last name

  - `middleName: optional string`

    User's middle name

  - `suffix1: optional string`

    Name suffix (e.g., 'MD', 'Jr.')

  - `suffix2: optional string`

    Additional name suffix

- `expressCustomer: optional object { expressCustomerId, expressCustomerName }`

  Reference to the Express customer this study belongs to

  - `expressCustomerId: string`

    Unique Express customer identifier. Format: cus_{32-hex-chars}

  - `expressCustomerName: string`

    Name of the Express customer

- `metadata: optional map[string]`

  Custom key-value metadata for the study. Maximum 50 pairs, keys up to 100 chars, values up to 1000 chars

- `priorReportTexts: optional array of string`

  Array of prior report texts to provide clinical context

- `priorStudyIds: optional array of string`

  Array of prior study IDs for comparison context (format: stu_{32-hex-chars})

- `reportIds: optional array of ReportIDWithStatus`

  Array of report IDs associated with this study, including addendums

  - `reportId: string`

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

  - `status: "in_progress" or "completed"`

    Current status of the report

    - `"in_progress"`

    - `"completed"`

### Example

```http
curl https://api.avarasoftware.com/v1/autoScribe/studies/by-uid/$STUDY_INSTANCE_UID \
    -H "Authorization: Bearer $AVARA_API_KEY"
```