Data Management with FHIR
0.1.0 - ci-build

Data Management with FHIR - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

## Logical Model: OMOPDrugExposure - Detailed Descriptions

Draft as of 2025-10-23

Definitions for the OMOPDrugExposure logical model.

- Key Elements Table
- Differential Elements Table
- Snapshot Elements Table

Guidance on how to interpret the contents of this table can be foundhere

0. OMOPDrugExposure
Définition | 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.
Short | Drug Occurrence OMOP Table
Control | 0..*
Is Modifier | false
Logical Model | Instances of this logical model are not marked to be the target of a Reference
2. OMOPDrugExposure.drug-exposure-id
Définition | 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.
Short | Drug Exposure Identifier
Control | 1..1
Type | integer
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
4. OMOPDrugExposure.person-id
Définition | The PERSON_ID of the PERSON for whom the drug dispensing or administration is recorded. This may be a system generated code.
Short | Person
Control | 1..1
Type | Reference(Person OMOP Table)
6. OMOPDrugExposure.drug-concept-id
Définition | 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.
Short | Drug
Control | 1..1
Type | Reference(Concept OMOP Table)
8. OMOPDrugExposure.drug-exposure-start-date
Définition | Use this date to determine the start date of the drug record.
Short | Drug Exposure Start Date
Control | 1..1
Type | date
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
10. OMOPDrugExposure.drug-exposure-start-datetime
Définition | Drug Exposure Start Datetime
Short | Drug Exposure Start Datetime
Control | 0..1
Type | dateTime
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
12. OMOPDrugExposure.drug-exposure-end-date
Définition | The DRUG_EXPOSURE_END_DATE denotes the day the drug exposure ended for the patient.
Short | Drug Exposure End Date
Control | 1..1
Type | date
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
14. OMOPDrugExposure.drug-exposure-end-datetime
Définition | Drug Exposure End Datetime
Short | Drug Exposure End Datetime
Control | 0..1
Type | dateTime
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
16. OMOPDrugExposure.verbatim-end-date
Définition | This is the end date of the drug exposure as it appears in the source data, if it is given
Short | Verbatim End Date
Control | 0..1
Type | date
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
18. OMOPDrugExposure.drug-type-concept-id
Définition | You can use the TYPE_CONCEPT_ID to delineate between prescriptions written vs. prescriptions dispensed vs. medication history vs. patient-reported exposure, etc.
Short | Drug Type
Control | 1..1
Type | Reference(Concept OMOP Table)
20. OMOPDrugExposure.stop-reason
Définition | 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.
Short | Stop Reason
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
22. OMOPDrugExposure.refills
Définition | 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.
Short | Refills
Control | 0..1
Type | integer
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
24. OMOPDrugExposure.quantity
Définition | Quantity
Short | Quantity
Control | 0..1
Type | decimal
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
26. OMOPDrugExposure.days-supply
Définition | Days Supply
Short | Days Supply
Control | 0..1
Type | integer
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
28. OMOPDrugExposure.sig
Définition | This is the verbatim instruction for the drug as written by the provider.
Short | Sig
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
30. OMOPDrugExposure.route-concept-id
Définition | Route
Short | Route
Control | 0..1
Type | Reference(Concept OMOP Table)
32. OMOPDrugExposure.lot-number
Définition | Lot Number
Short | Lot Number
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
34. OMOPDrugExposure.provider-id
Définition | The Provider associated with drug record, e.g. the provider who wrote the prescription or the provider who administered the drug.
Short | Provider
Control | 0..1
Type | Reference(Provider OMOP Table)
36. OMOPDrugExposure.visit-occurrence-id
Définition | The Visit during which the drug was prescribed, administered or dispensed.
Short | Visit Occurrence
Control | 0..1
Type | Reference(Visit Occurrence OMOP Table)
38. OMOPDrugExposure.visit-detail-id
Définition | 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.
Short | Visit Detail
Control | 0..1
Type | Reference(Visit Detail OMOP Table)
40. OMOPDrugExposure.drug-source-value
Définition | 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.
Short | Drug Source Value
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
42. OMOPDrugExposure.drug-source-concept-id
Définition | 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.
Short | Drug Source Concept
Control | 0..1
Type | Reference(Concept OMOP Table)
44. OMOPDrugExposure.route-source-value
Définition | This field houses the verbatim value from the source data representing the drug route.
Short | Route Source Value
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
46. OMOPDrugExposure.dose-unit-source-value
Définition | This field houses the verbatim value from the source data representing the dose unit of the drug given.
Short | Dose Unit Source Value
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension

Guidance on how to interpret the contents of this table can be foundhere

0. OMOPDrugExposure
Définition | 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.
Short | Drug Occurrence OMOP Table
Logical Model | Instances of this logical model are not marked to be the target of a Reference
2. OMOPDrugExposure.drug-exposure-id
Définition | 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.
Short | Drug Exposure Identifier
Control | 1..1
Type | integer
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
4. OMOPDrugExposure.person-id
Définition | The PERSON_ID of the PERSON for whom the drug dispensing or administration is recorded. This may be a system generated code.
Short | Person
Control | 1..1
Type | Reference(Person OMOP Table)
6. OMOPDrugExposure.drug-concept-id
Définition | 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.
Short | Drug
Control | 1..1
Type | Reference(Concept OMOP Table)
8. OMOPDrugExposure.drug-exposure-start-date
Définition | Use this date to determine the start date of the drug record.
Short | Drug Exposure Start Date
Control | 1..1
Type | date
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
10. OMOPDrugExposure.drug-exposure-start-datetime
Définition | Drug Exposure Start Datetime
Short | Drug Exposure Start Datetime
Control | 0..1
Type | dateTime
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
12. OMOPDrugExposure.drug-exposure-end-date
Définition | The DRUG_EXPOSURE_END_DATE denotes the day the drug exposure ended for the patient.
Short | Drug Exposure End Date
Control | 1..1
Type | date
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
14. OMOPDrugExposure.drug-exposure-end-datetime
Définition | Drug Exposure End Datetime
Short | Drug Exposure End Datetime
Control | 0..1
Type | dateTime
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
16. OMOPDrugExposure.verbatim-end-date
Définition | This is the end date of the drug exposure as it appears in the source data, if it is given
Short | Verbatim End Date
Control | 0..1
Type | date
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
18. OMOPDrugExposure.drug-type-concept-id
Définition | You can use the TYPE_CONCEPT_ID to delineate between prescriptions written vs. prescriptions dispensed vs. medication history vs. patient-reported exposure, etc.
Short | Drug Type
Control | 1..1
Type | Reference(Concept OMOP Table)
20. OMOPDrugExposure.stop-reason
Définition | 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.
Short | Stop Reason
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
22. OMOPDrugExposure.refills
Définition | 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.
Short | Refills
Control | 0..1
Type | integer
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
24. OMOPDrugExposure.quantity
Définition | Quantity
Short | Quantity
Control | 0..1
Type | decimal
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
26. OMOPDrugExposure.days-supply
Définition | Days Supply
Short | Days Supply
Control | 0..1
Type | integer
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
28. OMOPDrugExposure.sig
Définition | This is the verbatim instruction for the drug as written by the provider.
Short | Sig
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
30. OMOPDrugExposure.route-concept-id
Définition | Route
Short | Route
Control | 0..1
Type | Reference(Concept OMOP Table)
32. OMOPDrugExposure.lot-number
Définition | Lot Number
Short | Lot Number
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
34. OMOPDrugExposure.provider-id
Définition | The Provider associated with drug record, e.g. the provider who wrote the prescription or the provider who administered the drug.
Short | Provider
Control | 0..1
Type | Reference(Provider OMOP Table)
36. OMOPDrugExposure.visit-occurrence-id
Définition | The Visit during which the drug was prescribed, administered or dispensed.
Short | Visit Occurrence
Control | 0..1
Type | Reference(Visit Occurrence OMOP Table)
38. OMOPDrugExposure.visit-detail-id
Définition | 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.
Short | Visit Detail
Control | 0..1
Type | Reference(Visit Detail OMOP Table)
40. OMOPDrugExposure.drug-source-value
Définition | 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.
Short | Drug Source Value
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
42. OMOPDrugExposure.drug-source-concept-id
Définition | 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.
Short | Drug Source Concept
Control | 0..1
Type | Reference(Concept OMOP Table)
44. OMOPDrugExposure.route-source-value
Définition | This field houses the verbatim value from the source data representing the drug route.
Short | Route Source Value
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
46. OMOPDrugExposure.dose-unit-source-value
Définition | This field houses the verbatim value from the source data representing the dose unit of the drug given.
Short | Dose Unit Source Value
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension

Guidance on how to interpret the contents of this table can be foundhere

0. OMOPDrugExposure
Définition | 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.
Short | Drug Occurrence OMOP Table
Control | 0..*
Is Modifier | false
Logical Model | Instances of this logical model are not marked to be the target of a Reference
2. OMOPDrugExposure.drug-exposure-id
Définition | 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.
Short | Drug Exposure Identifier
Control | 1..1
Type | integer
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
4. OMOPDrugExposure.person-id
Définition | The PERSON_ID of the PERSON for whom the drug dispensing or administration is recorded. This may be a system generated code.
Short | Person
Control | 1..1
Type | Reference(Person OMOP Table)
6. OMOPDrugExposure.drug-concept-id
Définition | 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.
Short | Drug
Control | 1..1
Type | Reference(Concept OMOP Table)
8. OMOPDrugExposure.drug-exposure-start-date
Définition | Use this date to determine the start date of the drug record.
Short | Drug Exposure Start Date
Control | 1..1
Type | date
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
10. OMOPDrugExposure.drug-exposure-start-datetime
Définition | Drug Exposure Start Datetime
Short | Drug Exposure Start Datetime
Control | 0..1
Type | dateTime
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
12. OMOPDrugExposure.drug-exposure-end-date
Définition | The DRUG_EXPOSURE_END_DATE denotes the day the drug exposure ended for the patient.
Short | Drug Exposure End Date
Control | 1..1
Type | date
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
14. OMOPDrugExposure.drug-exposure-end-datetime
Définition | Drug Exposure End Datetime
Short | Drug Exposure End Datetime
Control | 0..1
Type | dateTime
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
16. OMOPDrugExposure.verbatim-end-date
Définition | This is the end date of the drug exposure as it appears in the source data, if it is given
Short | Verbatim End Date
Control | 0..1
Type | date
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
18. OMOPDrugExposure.drug-type-concept-id
Définition | You can use the TYPE_CONCEPT_ID to delineate between prescriptions written vs. prescriptions dispensed vs. medication history vs. patient-reported exposure, etc.
Short | Drug Type
Control | 1..1
Type | Reference(Concept OMOP Table)
20. OMOPDrugExposure.stop-reason
Définition | 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.
Short | Stop Reason
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
22. OMOPDrugExposure.refills
Définition | 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.
Short | Refills
Control | 0..1
Type | integer
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
24. OMOPDrugExposure.quantity
Définition | Quantity
Short | Quantity
Control | 0..1
Type | decimal
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
26. OMOPDrugExposure.days-supply
Définition | Days Supply
Short | Days Supply
Control | 0..1
Type | integer
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
28. OMOPDrugExposure.sig
Définition | This is the verbatim instruction for the drug as written by the provider.
Short | Sig
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
30. OMOPDrugExposure.route-concept-id
Définition | Route
Short | Route
Control | 0..1
Type | Reference(Concept OMOP Table)
32. OMOPDrugExposure.lot-number
Définition | Lot Number
Short | Lot Number
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
34. OMOPDrugExposure.provider-id
Définition | The Provider associated with drug record, e.g. the provider who wrote the prescription or the provider who administered the drug.
Short | Provider
Control | 0..1
Type | Reference(Provider OMOP Table)
36. OMOPDrugExposure.visit-occurrence-id
Définition | The Visit during which the drug was prescribed, administered or dispensed.
Short | Visit Occurrence
Control | 0..1
Type | Reference(Visit Occurrence OMOP Table)
38. OMOPDrugExposure.visit-detail-id
Définition | 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.
Short | Visit Detail
Control | 0..1
Type | Reference(Visit Detail OMOP Table)
40. OMOPDrugExposure.drug-source-value
Définition | 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.
Short | Drug Source Value
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
42. OMOPDrugExposure.drug-source-concept-id
Définition | 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.
Short | Drug Source Concept
Control | 0..1
Type | Reference(Concept OMOP Table)
44. OMOPDrugExposure.route-source-value
Définition | This field houses the verbatim value from the source data representing the drug route.
Short | Route Source Value
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
46. OMOPDrugExposure.dose-unit-source-value
Définition | This field houses the verbatim value from the source data representing the dose unit of the drug given.
Short | Dose Unit Source Value
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension