Patient Supplements

Discontinue a patient supplement

Marks a patient's supplement prescription as discontinued. This does not delete the record - the supplement will remain in the patient's history with a discontinued status.

patch/patients/{pt_id}/supplements/{pt_plan_other_id}/discontinue

Request

  • Base URL: https://clinic-subdomain.md-hq.com/api/v1
  • URL: https://clinic-subdomain.md-hq.com/api/v1/patients/{pt_id}/supplements/{pt_plan_other_id}/discontinue
  • Auth: HTTP basic

Path parameters

pt_idinteger required

ID of the patient

pt_plan_other_idinteger required

ID of the patient's supplement prescription to discontinue

Request body

discontinued_datestring date-time

Date and time when the supplement was discontinued. If not provided, defaults to the current date/time.

discontinued_notestring

Reason for discontinuing the supplement

Example request

{
  "discontinued_date": "2024-01-15T14:30:00Z",
  "discontinued_note": "No longer needed per provider recommendation"
}

Response

Supplement successfully discontinued. Returns the full supplement object.

objectstring

The plan type (e.g., "supplement", "supplement_otc")

idinteger

ID of the patient's supplement prescription

namestring

Name of the supplement

plan_typestring

Type classification of the plan

is_discontinuedboolean

Whether the supplement has been discontinued

associated_plan_idinteger
encounter_idinteger nullable
url_encounterstring nullable

URL to the associated encounter

createdstring date-time

Example response

{
  "object": "supplement"
}

Changes

No recorded changes to this operation across all 1 revision of this API.