Skip to main content

clinik.medicationStatements

Medication Statements (FHIR MedicationStatement) record what medications a patient is taking or has taken — as reported by the patient, clinician, or other source. Unlike prescriptions, these are informational records, not orders.

create

const { data, meta } = await clinik.medicationStatements.create(request: MedicationStatementCreateRequest): Promise<ApiResponse<MedicationStatement>>
FieldTypeRequiredDescription
statusstringYesactive, completed, stopped, on-hold, intended, not-taken
medicationstring | { system?, code, display? }YesMedication code or name
patientIdstringYesPatient ID
encounterIdstringNoEncounter ID
statusReasonstring[]NoReasons for current status
categorystringNoCategory (inpatient, outpatient, community)
effectiveDateTimestringNoWhen the medication was taken
effectivePeriod{ start?, end? }NoPeriod of medication use
dateAssertedstringNoWhen the statement was asserted
informationSourceIdstringNoWho provided the info
reasonCodestring[]NoReason codes for taking the medication
dosageTextstringNoDosage instructions
notestringNoAdditional notes
basedOnstring[]NoMedicationRequest/CarePlan/ServiceRequest IDs
partOfstring[]NoPart of other resource IDs

Example

const { data } = await clinik.medicationStatements.create({
  status: 'active',
  medication: 'Metformin 500mg Tablet',
  patientId: 'pt_abc123',
  category: 'community',
  effectivePeriod: {
    start: '2024-01-15',
  },
  dosageText: 'Take 1 tablet twice daily with meals',
  informationSourceId: 'Patient/pt_abc123',
  reasonCode: ['Type 2 diabetes management'],
  note: 'Patient reports good adherence, no side effects',
});
Same pattern as other resources. Update supports status, statusReason, note, effectiveDateTime, effectivePeriod. Search supports patientId, status, medication, category filters.