DrugExposure
type: StructureDefinition
node role: treeRoot
id:
  v: DrugExposure
language:
  v: en
text:
  status:
    v: extensions
  div:
    v: Generated Narrative: StructureDefinition DrugExposure Name Flags Card. Type Description & Constraints<img src="[binary]" alt="doco" style="background-color: inherit"/> <a href="StructureDefinition-DrugExposure-definitions.html#DrugExposure" title="This table captures records about the exposure to a Drug ingested or otherwise introduced into the body. A Drug is a biochemical substance formulated in such a way that when administered to a Person it will exert a certain biochemical effect on the metabolism. Drugs include prescription and over-the-counter medicines, vaccines, and large-molecule biologic therapies. Radiological devices ingested or applied locally do not count as Drugs.">DrugExposure 0..* Base Drug Exposure OMOP Table Instances of this logical model can be the target of a Reference #xD; drug_exposure_id 1..1 integer Drug Exposure Identifier #xD; person_id 1..1 integer Person #xD; <a href="StructureDefinition-DrugExposure-definitions.html#DrugExposure.drug-concept-id" title="The DRUG_CONCEPT_ID field is recommended for primary use in analyses, and must be used for network studies. This is the standard concept mapped from the source concept id which represents a drug product or molecule otherwise introduced to the body. The drug concepts can have a varying degree of information about drug strength and dose. This information is relevant in the context of quantity and administration information in the subsequent fields plus strength information from the DRUG_STRENGTH table, provided as part of the standard vocabulary download.">drug_concept_id 1..1 code Drug #xD; drug_exposure_start_date 1..1 date Drug Exposure Start Date #xD; drug_exposure_start_datetime 0..1 dateTime Drug Exposure Start Datetime #xD; drug_exposure_end_date 1..1 date Drug Exposure End Date #xD; drug_exposure_end_datetime 0..1 dateTime Drug Exposure End Datetime #xD; verbatim_end_date 0..1 date Verbatim End Date #xD; drug_type_concept_id 1..1 code Drug Type #xD; stop_reason 0..1 string Stop Re…
extension:
  url:
    v: http://hl7.org/fhir/StructureDefinition/structuredefinition-type-characteristics
    l: structuredefinition-type-characteristics
  value: Code
    v: can-be-target
extension:
  url:
    v: http://hl7.org/fhir/StructureDefinition/structuredefinition-wg
    l: structuredefinition-wg
  value: Code
    v: brr
extension:
  url:
    v: http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm
    l: structuredefinition-fmm
  value: Integer
    v: 2
    extension:
      url:
        v: http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom
        l: structuredefinition-conformance-derivedFrom
      value: Canonical
        v: http://hl7.org/fhir/uv/omop/ImplementationGuide/hl7.fhir.uv.omop
        l: hl7.fhir.uv.omop
extension:
  url:
    v: http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status
    l: structuredefinition-standards-status
  value: Code
    v: informative
    extension:
      url:
        v: http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom
        l: structuredefinition-conformance-derivedFrom
      value: Canonical
        v: http://hl7.org/fhir/uv/omop/ImplementationGuide/hl7.fhir.uv.omop
        l: hl7.fhir.uv.omop
url:
  v: http://hl7.org/fhir/uv/omop/StructureDefinition/DrugExposure
  l: DrugExposure
version:
  v: 1.0.0
name:
  v: DrugExposure
title:
  v: Drug Exposure OMOP Table
status:
  v: active
date:
  v: 2026-04-30T00:07:42+10:00
publisher:
  v: HL7 International / Biomedical Research and Regulation
contact:
  name:
    v: HL7 International / Biomedical Research and Regulation
  telecom:
    system:
      v: url
    value:
      v: http://www.hl7.org/Special/committees/rcrim
description:
  v: This table captures records about the exposure to a Drug ingested or otherwise introduced into the body. A Drug is a biochemical substance formulated in such a way that when administered to a Person it will exert a certain biochemical effect on the metabolism. Drugs include prescription and over-the-counter medicines, vaccines, and large-molecule biologic therapies. Radiological devices ingested or applied locally do not count as Drugs.
jurisdiction:
  coding:
    system:
      v: http://unstats.un.org/unsd/methods/m49/m49.htm
      l: m49.htm
    code:
      v: 001
    display:
      v: World
fhir version:
  v: 5.0.0
mapping:
  identity:
    v: rim
  uri:
    v: http://hl7.org/v3
    l: v3
  name:
    v: RIM Mapping
kind:
  v: logical
abstract:
  v: false
type:
  v: http://hl7.org/fhir/uv/omop/StructureDefinition/DrugExposure
  l: DrugExposure
base definition:
  v: http://hl7.org/fhir/StructureDefinition/Base
  l: Base
derivation:
  v: specialization
snapshot:
  extension:
    url:
      v: http://hl7.org/fhir/tools/StructureDefinition/snapshot-base-version
      l: snapshot-base-version
    value: String
      v: 5.0.0
  element:
    id:
      v: DrugExposure
    path:
      v: DrugExposure
    short:
      v: Drug Exposure OMOP Table
    definition:
      v: This table captures records about the exposure to a Drug ingested or otherwise introduced into the body. A Drug is a biochemical substance formulated in such a way that when administered to a Person it will exert a certain biochemical effect on the metabolism. Drugs include prescription and over-the-counter medicines, vaccines, and large-molecule biologic therapies. Radiological devices ingested or applied locally do not count as Drugs.
    min:
      v: 0
    max:
      v: *
    base:
      path:
        v: Base
      min:
        v: 0
      max:
        v: *
    is modifier:
      v: false
    mapping:
      identity:
        v: rim
      map:
        v: n/a
  element:
    id:
      v: DrugExposure.drug-exposure-id
    path:
      v: DrugExposure.drug_exposure_id
    short:
      v: Drug Exposure Identifier
    definition:
      v: The unique key given to records of drug dispensings or administrations for a person. Refer to the ETL for how duplicate drugs during the same visit were handled.
    min:
      v: 1
    max:
      v: 1
    base:
      path:
        v: DrugExposure.drug_exposure_id
      min:
        v: 1
      max:
        v: 1
    type:
      code:
        v: integer
        l: integer
  element:
    id:
      v: DrugExposure.person-id
    path:
      v: DrugExposure.person_id
    short:
      v: Person
    definition:
      v: The PERSON_ID of the PERSON for whom the drug dispensing or administration is recorded. This may be a system generated code.
    min:
      v: 1
    max:
      v: 1
    base:
      path:
        v: DrugExposure.person_id
      min:
        v: 1
      max:
        v: 1
    type:
      code:
        v: integer
        l: integer
  element:
    id:
      v: DrugExposure.drug-concept-id
    path:
      v: DrugExposure.drug_concept_id
    short:
      v: Drug
    definition:
      v: The DRUG_CONCEPT_ID field is recommended for primary use in analyses, and must be used for network studies. This is the standard concept mapped from the source concept id which represents a drug product or molecule otherwise introduced to the body. The drug concepts can have a varying degree of information about drug strength and dose. This information is relevant in the context of quantity and administration information in the subsequent fields plus strength information from the DRUG_STRENGTH table, provided as part of the standard vocabulary download.
    min:
      v: 1
    max:
      v: 1
    base:
      path:
        v: DrugExposure.drug_concept_id

v: 1

v: 1

code:
  v: code
  l: code

id:
  v: DrugExposure.drug-exposure-start-date
path:
  v: DrugExposure.drug_exposure_start_date
short:
  v: Drug Exposure Start Date
definition:
  v: Use this date to determine the start date of the drug record.
min:
  v: 1
max:
  v: 1
base:
  path:
    v: DrugExposure.drug_exposure_start_date
  min:
    v: 1
  max:
    v: 1
type:
  code:
    v: date
    l: date

id:
  v: DrugExposure.drug-exposure-start-datetime
path:
  v: DrugExposure.drug_exposure_start_datetime
short:
  v: Drug Exposure Start Datetime
definition:
  v: Drug Exposure Start Datetime
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DrugExposure.drug_exposure_start_datetime
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: dateTime
    l: dateTime

id:
  v: DrugExposure.drug-exposure-end-date
path:
  v: DrugExposure.drug_exposure_end_date
short:
  v: Drug Exposure End Date
definition:
  v: The DRUG_EXPOSURE_END_DATE denotes the day the drug exposure ended for the patient.
min:
  v: 1
max:
  v: 1
base:
  path:
    v: DrugExposure.drug_exposure_end_date
  min:
    v: 1
  max:
    v: 1
type:
  code:
    v: date
    l: date

id:
  v: DrugExposure.drug-exposure-end-datetime
path:
  v: DrugExposure.drug_exposure_end_datetime
short:
  v: Drug Exposure End Datetime
definition:
  v: Drug Exposure End Datetime
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DrugExposure.drug_exposure_end_datetime
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: dateTime
    l: dateTime

id:
  v: DrugExposure.verbatim-end-date
path:
  v: DrugExposure.verbatim_end_date
short:
  v: Verbatim End Date
definition:
  v: This is the end date of the drug exposure as it appears in the source data, if it is given
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DrugExposure.verbatim_end_date
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: date
    l: date

id:
  v: DrugExposure.drug-type-concept-id
path:
  v: DrugExposure.drug_type_concept_id
short:
  v: Drug Type
definition:
  v: You can use the TYPE_CONCEPT_ID to delineate between prescriptions written vs. prescriptions dispensed vs. medication history vs. patient-reported exposure, etc.
min:
  v: 1
max:
  v: 1
base:
  path:
    v: DrugExposure.drug_type_concept_id
  min:
    v: 1
  max:
    v: 1
type:
  code:
    v: code
    l: code

id:
  v: DrugExposure.stop-reason
path:
  v: DrugExposure.stop_reason
short:
  v: Stop Reason
definition:
  v: The reason a person stopped a medication as it is represented in the source. Reasons include regimen completed, changed, removed, etc. This field will be retired in v6.0.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DrugExposure.stop_reason
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string

id:
  v: DrugExposure.refills
path:
  v: DrugExposure.refills
short:
  v: Refills
definition:
  v: This is only filled in when the record is coming from a prescription written this field is meant to represent intended refills at time of the prescription.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DrugExposure.refills
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: integer
    l: integer

id:
  v: DrugExposure.quantity
path:
  v: DrugExposure.quantity
short:
  v: Quantity
definition:
  v: Quantity
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DrugExposure.quantity
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: decimal
    l: decimal

id:
  v: DrugExposure.days-supply
path:
  v: DrugExposure.days_supply
short:
  v: Days Supply
definition:
  v: Days Supply
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DrugExposure.days_supply
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: integer
    l: integer

id:
  v: DrugExposure.sig
path:
  v: DrugExposure.sig
short:
  v: Sig
definition:
  v: This is the verbatim instruction for the drug as written by the provider.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DrugExposure.sig
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string

id:
  v: DrugExposure.route-concept-id
path:
  v: DrugExposure.route_concept_id
short:
  v: Route
definition:
  v: Route
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DrugExposure.route_concept_id
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: code
    l: code

id:
  v: DrugExposure.lot-number
path:
  v: DrugExposure.lot_number
short:
  v: Lot Number
definition:
  v: Lot Number
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DrugExposure.lot_number
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string

id:
  v: DrugExposure.provider-id
path:
  v: DrugExposure.provider_id
short:
  v: Provider
definition:
  v: The Provider associated with drug record, e.g. the provider who wrote the prescription or the provider who administered the drug.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DrugExposure.provider_id
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: integer
    l: integer

id:
  v: DrugExposure.visit-occurrence-id
path:
  v: DrugExposure.visit_occurrence_id
short:
  v: Visit Occurrence
definition:
  v: The Visit during which the drug was prescribed, administered or dispensed.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DrugExposure.visit_occurrence_id
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: integer
    l: integer

id:
  v: DrugExposure.visit-detail-id
path:
  v: DrugExposure.visit_detail_id
short:
  v: Visit Detail
definition:
  v: The VISIT_DETAIL record during which the drug exposure occurred. For example, if the person was in the ICU at the time of the drug administration the VISIT_OCCURRENCE record would reflect the overall hospital stay and the VISIT_DETAIL record would reflect the ICU stay during the hospital visit.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DrugExposure.visit_detail_id
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: integer
    l: integer

id:
  v: DrugExposure.drug-source-value
path:
  v: DrugExposure.drug_source_value
short:
  v: Drug Source Value
definition:
  v: This field houses the verbatim value from the source data representing the drug exposure that occurred. For example, this could be an NDC or Gemscript code.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DrugExposure.drug_source_value
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string

id:
  v: DrugExposure.drug-source-concept-id
path:
  v: DrugExposure.drug_source_concept_id
short:
  v: Drug Source Concept
definition:
  v: This is the concept representing the drug source value and may not necessarily be standard. This field is discouraged from use in analysis because it is not required to contain Standard Concepts that are used across the OHDSI community, and should only be used when Standard Concepts do not adequately represent the source detail for the Drug necessary for a given analytic use case. Consider using DRUG_CONCEPT_ID instead to enable standardized analytics that can be consistent across the network.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DrugExposure.drug_source_concept_id
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: code
    l: code

id:
  v: DrugExposure.route-source-value
path:
  v: DrugExposure.route_source_value
short:
  v: Route Source Value
definition:
  v: This field houses the verbatim value from the source data representing the drug route.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DrugExposure.route_source_value
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string

id:
  v: DrugExposure.dose-unit-source-value
path:
  v: DrugExposure.dose_unit_source_value
short:
  v: Dose Unit Source Value
definition:
  v: This field houses the verbatim value from the source data representing the dose unit of the drug given.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DrugExposure.dose_unit_source_value
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string

element:
  id:
    v: DrugExposure
  path:
    v: DrugExposure
  short:
    v: Drug Exposure OMOP Table
  definition:
    v: This table captures records about the exposure to a Drug ingested or otherwise introduced into the body. A Drug is a biochemical substance formulated in such a way that when administered to a Person it will exert a certain biochemical effect on the metabolism. Drugs include prescription and over-the-counter medicines, vaccines, and large-molecule biologic therapies. Radiological devices ingested or applied locally do not count as Drugs.
element:
  id:
    v: DrugExposure.drug-exposure-id
  path:
    v: DrugExposure.drug_exposure_id
  short:
    v: Drug Exposure Identifier
  definition:
    v: The unique key given to records of drug dispensings or administrations for a person. Refer to the ETL for how duplicate drugs during the same visit were handled.
  min:
    v: 1
  max:
    v: 1
  type:
    code:
      v: integer
      l: integer
element:
  id:
    v: DrugExposure.person-id
  path:
    v: DrugExposure.person_id
  short:
    v: Person
  definition:
    v: The PERSON_ID of the PERSON for whom the drug dispensing or administration is recorded. This may be a system generated code.
  min:
    v: 1
  max:
    v: 1
  type:
    code:
      v: integer
      l: integer
element:
  id:
    v: DrugExposure.drug-concept-id
  path:
    v: DrugExposure.drug_concept_id
  short:
    v: Drug
  definition:
    v: The DRUG_CONCEPT_ID field is recommended for primary use in analyses, and must be used for network studies. This is the standard concept mapped from the source concept id which represents a drug product or molecule otherwise introduced to the body. The drug concepts can have a varying degree of information about drug strength and dose. This information is relevant in the context of quantity and administration information in the subsequent fields plus strength information from the DRUG_STRENGTH table, provided as part of the standard vocabulary download.
  min:
    v: 1
  max:
    v: 1
  type:
    code:
      v: code
      l: code
element:
  id:
    v: DrugExposure.drug-exposure-start-date
  path:
    v: DrugExposure.drug_exposure_start_date
  short:
    v: Drug Exposure Start Date
  definition:
    v: Use this date to determine the start date of the drug record.
  min:
    v: 1
  max:
    v: 1
  type:
    code:
      v: date
      l: date
element:
  id:
    v: DrugExposure.drug-exposure-start-datetime
  path:
    v: DrugExposure.drug_exposure_start_datetime
  short:
    v: Drug Exposure Start Datetime
  definition:
    v: Drug Exposure Start Datetime
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: dateTime
      l: dateTime
element:
  id:
    v: DrugExposure.drug-exposure-end-date
  path:
    v: DrugExposure.drug_exposure_end_date
  short:
    v: Drug Exposure End Date
  definition:
    v: The DRUG_EXPOSURE_END_DATE denotes the day the drug exposure ended for the patient.
  min:
    v: 1
  max:
    v: 1
  type:
    code:
      v: date
      l: date
element:
  id:
    v: DrugExposure.drug-exposure-end-datetime
  path:
    v: DrugExposure.drug_exposure_end_datetime
  short:
    v: Drug Exposure End Datetime
  definition:
    v: Drug Exposure End Datetime
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: dateTime
      l: dateTime
element:
  id:
    v: DrugExposure.verbatim-end-date
  path:
    v: DrugExposure.verbatim_end_date
  short:
    v: Verbatim End Date
  definition:
    v: This is the end date of the drug exposure as it appears in the source data, if it is given
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: date
      l: date
element:
  id:
    v: DrugExposure.drug-type-concept-id
  path:
    v: DrugExposure.drug_type_concept_id
  short:
    v: Drug Type
  definition:
    v: You can use the TYPE_CONCEPT_ID to delineate between prescriptions written vs. prescriptions dispensed vs. medication history vs. patient-reported exposure, etc.
  min:
    v: 1
  max:
    v: 1
  type:
    code:
      v: code
      l: code
element:
  id:
    v: DrugExposure.stop-reason
  path:
    v: DrugExposure.stop_reason
  short:
    v: Stop Reason
  definition:
    v: The reason a person stopped a medication as it is represented in the source. Reasons include regimen completed, changed, removed, etc. This field will be retired in v6.0.
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: string
      l: string
element:
  id:
    v: DrugExposure.refills
  path:
    v: DrugExposure.refills
  short:
    v: Refills
  definition:
    v: This is only filled in when the record is coming from a prescription written this field is meant to represent intended refills at time of the prescription.
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: integer
      l: integer
element:
  id:
    v: DrugExposure.quantity
  path:
    v: DrugExposure.quantity

v: Quantity

v: Quantity

v: 0

v: 1

code:
  v: decimal
  l: decimal

id:
  v: DrugExposure.days-supply
path:
  v: DrugExposure.days_supply
short:
  v: Days Supply
definition:
  v: Days Supply
min:
  v: 0
max:
  v: 1
type:
  code:
    v: integer
    l: integer

id:
  v: DrugExposure.sig
path:
  v: DrugExposure.sig
short:
  v: Sig
definition:
  v: This is the verbatim instruction for the drug as written by the provider.
min:
  v: 0
max:
  v: 1
type:
  code:
    v: string
    l: string

id:
  v: DrugExposure.route-concept-id
path:
  v: DrugExposure.route_concept_id
short:
  v: Route
definition:
  v: Route
min:
  v: 0
max:
  v: 1
type:
  code:
    v: code
    l: code

id:
  v: DrugExposure.lot-number
path:
  v: DrugExposure.lot_number
short:
  v: Lot Number
definition:
  v: Lot Number
min:
  v: 0
max:
  v: 1
type:
  code:
    v: string
    l: string

id:
  v: DrugExposure.provider-id
path:
  v: DrugExposure.provider_id
short:
  v: Provider
definition:
  v: The Provider associated with drug record, e.g. the provider who wrote the prescription or the provider who administered the drug.
min:
  v: 0
max:
  v: 1
type:
  code:
    v: integer
    l: integer

id:
  v: DrugExposure.visit-occurrence-id
path:
  v: DrugExposure.visit_occurrence_id
short:
  v: Visit Occurrence
definition:
  v: The Visit during which the drug was prescribed, administered or dispensed.
min:
  v: 0
max:
  v: 1
type:
  code:
    v: integer
    l: integer

id:
  v: DrugExposure.visit-detail-id
path:
  v: DrugExposure.visit_detail_id
short:
  v: Visit Detail
definition:
  v: The VISIT_DETAIL record during which the drug exposure occurred. For example, if the person was in the ICU at the time of the drug administration the VISIT_OCCURRENCE record would reflect the overall hospital stay and the VISIT_DETAIL record would reflect the ICU stay during the hospital visit.
min:
  v: 0
max:
  v: 1
type:
  code:
    v: integer
    l: integer

id:
  v: DrugExposure.drug-source-value
path:
  v: DrugExposure.drug_source_value
short:
  v: Drug Source Value
definition:
  v: This field houses the verbatim value from the source data representing the drug exposure that occurred. For example, this could be an NDC or Gemscript code.
min:
  v: 0
max:
  v: 1
type:
  code:
    v: string
    l: string

id:
  v: DrugExposure.drug-source-concept-id
path:
  v: DrugExposure.drug_source_concept_id
short:
  v: Drug Source Concept
definition:
  v: This is the concept representing the drug source value and may not necessarily be standard. This field is discouraged from use in analysis because it is not required to contain Standard Concepts that are used across the OHDSI community, and should only be used when Standard Concepts do not adequately represent the source detail for the Drug necessary for a given analytic use case. Consider using DRUG_CONCEPT_ID instead to enable standardized analytics that can be consistent across the network.
min:
  v: 0
max:
  v: 1
type:
  code:
    v: code
    l: code

id:
  v: DrugExposure.route-source-value
path:
  v: DrugExposure.route_source_value
short:
  v: Route Source Value
definition:
  v: This field houses the verbatim value from the source data representing the drug route.
min:
  v: 0
max:
  v: 1
type:
  code:
    v: string
    l: string

id:
  v: DrugExposure.dose-unit-source-value
path:
  v: DrugExposure.dose_unit_source_value
short:
  v: Dose Unit Source Value
definition:
  v: This field houses the verbatim value from the source data representing the dose unit of the drug given.
min:
  v: 0
max:
  v: 1
type:
  code:
    v: string
    l: string