Skip to main content

Device Requests

Device Requests (FHIR DeviceRequest) represent orders or proposals for a device to be provided or used for a patient. They support the full ordering lifecycle from proposal through completion.

Create a Device Request

const { data: request } = await clinik.deviceRequests.create({
  intent: 'order',
  code: 'Continuous Glucose Monitor',
  patientId: 'pt_abc123',
  status: 'active',
  priority: 'routine',
  requesterId: 'prac_dr456',
  occurrenceDateTime: '2024-03-01',
  reasonCode: ['Type 2 Diabetes — glucose monitoring'],
  note: 'Patient to use CGM for 14-day glucose monitoring cycle',
});

Using Coded Devices

You can use coded values for precise device identification:
const { data } = await clinik.deviceRequests.create({
  intent: 'order',
  code: {
    system: 'http://snomed.info/sct',
    code: '706689003',
    display: 'Continuous glucose monitoring system',
  },
  patientId: 'pt_abc123',
  priority: 'urgent',
  requesterId: 'prac_dr456',
});

Request Lifecycle

// Draft → Active → Completed
await clinik.deviceRequests.update(request.id, {
  status: 'completed',
  note: 'CGM delivered and activated for patient',
});

Search Device Requests

// Find all active device requests for a patient
const { data } = await clinik.deviceRequests.search({
  patientId: 'pt_abc123',
  status: 'active',
});

// Find all orders
const { data: orders } = await clinik.deviceRequests.search({
  intent: 'order',
  status: 'active',
});

Intent Values

IntentDescription
proposalSuggestion for device use
planPlanned device use
directivePatient or related person request
orderFormal order for device
original-orderOriginal order from requester
reflex-orderAuto-generated order
filler-orderOrder from fulfiller
instance-orderSpecific instance of an order
optionOption for consideration