Skip to main content

​
clinik.nutritionOrders

Nutrition orders (FHIR NutritionOrder) represent dietary orders for patients — oral diets, supplements, and enteral formulas.

​
create

const { data, meta } = await clinik.nutritionOrders.create(request): Promise<ApiResponse<NutritionOrder>>
FieldTypeRequiredDescription
statusstringYesdraft, active, on-hold, revoked, completed
intentstringYesproposal, plan, directive, order
patientIdstringYesPatient reference
encounterIdstringNoEncounter context
dateTimestringNoOrder date (defaults to now)
ordererIdstringNoOrdering practitioner ID
allergyIntoleranceIdsstring[]NoAllergy references
foodPreferenceModifierstring[]NoFood preferences
excludeFoodModifierstring[]NoFoods to exclude
oralDietobjectNoOral diet specification
supplementArray<object>NoSupplement orders
enteralFormulaobjectNoEnteral formula order
notestringNoAdditional notes

​
oralDiet

FieldTypeDescription
typestring[]Diet types (e.g. “low-sodium”, “diabetic”)
instructionstringPreparation instructions
nutrientArray<{ modifier?, amount? }>Nutrient modifications

​
supplement

FieldTypeDescription
typestringSupplement type
productNamestringProduct name
quantity{ value, unit? }Amount per serving
instructionstringAdministration instructions

​
enteralFormula

FieldTypeDescription
baseFormulaTypestringFormula type
baseFormulaProductNamestringProduct name
additiveTypestringAdditive type
routeOfAdministrationstringRoute (e.g. “nasogastric tube”)
administrationInstructionstringInstructions

​
Example

const { data } = await clinik.nutritionOrders.create({
  status: 'active',
  intent: 'order',
  patientId: 'pt_abc123',
  ordererId: 'prac_def456',
  oralDiet: {
    type: ['diabetic', 'low-sodium'],
    instruction: 'No added salt. Limit carbohydrates to 45g per meal.',
    nutrient: [
      { modifier: 'Sodium', amount: { value: 2000, unit: 'mg' } },
      { modifier: 'Carbohydrate', amount: { value: 135, unit: 'g' } },
    ],
  },
  excludeFoodModifier: ['shellfish', 'peanuts'],
  note: 'Patient has a history of diabetic ketoacidosis',
});
Same pattern as other resources. Search supports patientId, status, dateFrom, dateTo filters.