---
title: "Create Discontinued Medication"
method: POST
path: "/api/2.0/discontinued_medications/"
tags: ["Discontinued Medications"]
---

# Create Discontinued Medication

`POST /api/2.0/discontinued_medications/`

## Request body

- DiscontinueMedOrder
  - `chart_date` string, date-time — The timestamp at which this discontinue was available in the patient's chart
  - `created_date` string, date-time, nullable — The timestamp at which this discontinue was created in our database.
  - `deleted_date` string, date-time, nullable — The timestamp at which the discontinue was marked as deleted, usually occurs when a user wants to 'undiscontinue' the medication.
  - `discontinue_date` string, date — The date when the medication was discontinued.
  - `document_date` string, date-time — The timestamp at which we've documented this discontinue occurred.
  - `documenting_personnel` integer — The user who documented this discontinue.
  - `id` integer — The id of the discontinue medication.
  - `is_documented` boolean
  - `last_medication_order` integer, nullable — The id of the last medication ordered before we discontinued this thread of med orders.
  - `med_order` integer, required — The id of the medication which we discontinued.
  - `medication` Medication
    - `active_ndcs` string[]
    - `brand_name` string
    - `created_date` string, date-time, nullable
    - `creation_type` 'user' | 'medispan' | 'ss' | 'disp' — * `user` - user * `medispan` - medispan * `ss` - surescripts * `disp` - dispensary
    - `form` string
    - `generic_name` string
    - `id` integer — The id of the medication.
    - `is_controlled` boolean — Whether the drug is a controlled substance or not.
    - `market_end_date` string, date-time, nullable
    - `name` string — The name that will display for the medication in the search and when referenced by the prescription or documented med.
    - `ndcs` string[] — The NDCs of the medication (must contain only one ndc code when creating).
    - `obsolete_date` string, date-time, nullable — The date at which this practice medication became obsolete.
    - `practice` integer — The practice that created the medication. `null` for medications from the standard formulary.
    - `route` string
    - `rxnorm_cuis` string[] — The Rxnorm.cui code of the medication (must contain only one cui code when creating).
    - `strength` string, nullable — The strength of the drug, e.g. 40mg.
    - `type` 'otc' | 'prescription' | 'discontinued' — * `otc` - otc * `prescription` - prescription * `discontinued` - discontinued
  - `patient` integer — The id of the patient chart.
  - `practice` integer — The id of the practice.
  - `prescribing_physician` integer — The id of the physician who prescribed the medication.
  - `reason` string, nullable — The discontinue reason.
  - `signed_by` integer
  - `signed_date` string, date-time, nullable — The timestamp at which a user signed off on the discontinue.
  - `supervising_physician` integer, nullable — If the prescribing physician requires supervision, this will reference the physician who is in that role.
  - `thread` integer

## Response `201`

- DiscontinueMedOrder
  - `chart_date` string, date-time — The timestamp at which this discontinue was available in the patient's chart
  - `created_date` string, date-time, nullable — The timestamp at which this discontinue was created in our database.
  - `deleted_date` string, date-time, nullable — The timestamp at which the discontinue was marked as deleted, usually occurs when a user wants to 'undiscontinue' the medication.
  - `discontinue_date` string, date — The date when the medication was discontinued.
  - `document_date` string, date-time — The timestamp at which we've documented this discontinue occurred.
  - `documenting_personnel` integer — The user who documented this discontinue.
  - `id` integer — The id of the discontinue medication.
  - `is_documented` boolean
  - `last_medication_order` integer, nullable — The id of the last medication ordered before we discontinued this thread of med orders.
  - `med_order` integer, required — The id of the medication which we discontinued.
  - `medication` Medication
    - `active_ndcs` string[]
    - `brand_name` string
    - `created_date` string, date-time, nullable
    - `creation_type` 'user' | 'medispan' | 'ss' | 'disp' — * `user` - user * `medispan` - medispan * `ss` - surescripts * `disp` - dispensary
    - `form` string
    - `generic_name` string
    - `id` integer — The id of the medication.
    - `is_controlled` boolean — Whether the drug is a controlled substance or not.
    - `market_end_date` string, date-time, nullable
    - `name` string — The name that will display for the medication in the search and when referenced by the prescription or documented med.
    - `ndcs` string[] — The NDCs of the medication (must contain only one ndc code when creating).
    - `obsolete_date` string, date-time, nullable — The date at which this practice medication became obsolete.
    - `practice` integer — The practice that created the medication. `null` for medications from the standard formulary.
    - `route` string
    - `rxnorm_cuis` string[] — The Rxnorm.cui code of the medication (must contain only one cui code when creating).
    - `strength` string, nullable — The strength of the drug, e.g. 40mg.
    - `type` 'otc' | 'prescription' | 'discontinued' — * `otc` - otc * `prescription` - prescription * `discontinued` - discontinued
  - `patient` integer — The id of the patient chart.
  - `practice` integer — The id of the practice.
  - `prescribing_physician` integer — The id of the physician who prescribed the medication.
  - `reason` string, nullable — The discontinue reason.
  - `signed_by` integer
  - `signed_date` string, date-time, nullable — The timestamp at which a user signed off on the discontinue.
  - `supervising_physician` integer, nullable — If the prescribing physician requires supervision, this will reference the physician who is in that role.
  - `thread` integer

---

[API](https://skmtc.net/elationhealth/apis/api-authentication.md) · [All operations](https://skmtc.net/elationhealth/apis/api-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elationhealth/api-authentication/revisions/c060f89d4de7/schema)