Skip to main content

Imaging Studies

Imaging Studies (FHIR ImagingStudy) represent radiology and diagnostic imaging exams such as CT scans, MRIs, X-rays, and ultrasounds. ClinikAPI simplifies series to key fields — use the FHIR passthrough for DICOM instance-level access.

Record a CT Scan

const { data: study } = await clinik.imagingStudies.create({
  status: 'available',
  patientId: 'pt_jane123',
  encounterId: 'enc_er456',
  modality: ['CT'],
  started: '2024-03-15T10:00:00Z',
  referrerId: 'prac_drSmith',
  numberOfSeries: 2,
  numberOfInstances: 120,
  procedureCode: ['CT chest with contrast'],
  locationId: 'loc_radiology',
  description: 'CT Chest — rule out pulmonary embolism',
  reasonCode: ['Shortness of breath', 'Chest pain'],
  series: [
    {
      uid: '1.2.840.113619.2.55.3.604688119.969.1364202859.234',
      number: 1,
      modality: 'CT',
      description: 'Axial images with contrast',
      numberOfInstances: 80,
      bodySite: 'Chest',
    },
    {
      uid: '1.2.840.113619.2.55.3.604688119.969.1364202859.235',
      number: 2,
      modality: 'CT',
      description: 'Coronal reformats',
      numberOfInstances: 40,
      bodySite: 'Chest',
    },
  ],
  basedOn: ['ServiceRequest/sr_ctChest789'],
});

MRI Study

const { data: mri } = await clinik.imagingStudies.create({
  status: 'available',
  patientId: 'pt_john456',
  modality: ['MR'],
  started: '2024-03-16T08:30:00Z',
  referrerId: 'prac_drOrtho',
  interpreterIds: ['prac_drRadiologist'],
  numberOfSeries: 4,
  numberOfInstances: 200,
  procedureCode: ['MRI knee without contrast'],
  description: 'MRI Right Knee — evaluate meniscal tear',
  reasonCode: ['Right knee pain', 'Locking sensation'],
  series: [
    {
      uid: '1.2.840.113619.2.55.3.604688119.969.1364202860.100',
      number: 1,
      modality: 'MR',
      description: 'Sagittal PD fat-sat',
      numberOfInstances: 50,
      bodySite: 'Right knee',
      laterality: 'R',
    },
  ],
});

Simple X-Ray (No Series Detail)

const { data: xray } = await clinik.imagingStudies.create({
  status: 'available',
  patientId: 'pt_jane123',
  modality: ['XR'],
  started: '2024-03-15T11:00:00Z',
  referrerId: 'prac_drSmith',
  numberOfSeries: 1,
  numberOfInstances: 2,
  procedureCode: ['XR chest 2 views'],
  description: 'Chest X-ray PA and lateral',
});

Search Imaging Studies

// All studies for a patient
const { data } = await clinik.imagingStudies.search({
  patientId: 'pt_jane123',
});

// Filter by modality
const { data: ctScans } = await clinik.imagingStudies.search({
  patientId: 'pt_jane123',
  modality: 'CT',
});

// Filter by date range
const { data: recent } = await clinik.imagingStudies.search({
  dateFrom: '2024-03-01',
  dateTo: '2024-03-31',
  status: 'available',
});

Common Modalities

CodeDescription
CTComputed Tomography
MRMagnetic Resonance
USUltrasound
XRX-Ray (Radiography)
NMNuclear Medicine
PTPET Scan
MGMammography
RFFluoroscopy