# MedicinalProduct

Canonical page: https://docs.ovok.com/api/fhir/r4/medicinal-product

Detailed definition of a medicinal product, typically for uses other than direct patient care (e.g. regulatory use).

These interaction paths describe standard FHIR R4 patterns. Availability can depend on the API capabilities enabled for your Ovok project.

| **Interaction** | **Method** | **Path** |
| --- | --- | --- |
| Read | `GET` | `/fhir/R4/MedicinalProduct/[id]` |
| Vread | `GET` | `/fhir/R4/MedicinalProduct/[id]/_history/[vid]` |
| Update | `PUT` | `/fhir/R4/MedicinalProduct/[id]` |
| Patch | `PATCH` | `/fhir/R4/MedicinalProduct/[id]` |
| Delete | `DELETE` | `/fhir/R4/MedicinalProduct/[id]` |
| Create | `POST` | `/fhir/R4/MedicinalProduct` |
| Search | `GET` | `/fhir/R4/MedicinalProduct` |
| History | `GET` | `/fhir/R4/MedicinalProduct/[id]/_history` |

## Top-level elements [#top-level-elements]

| **Element** | **Type** | **Cardinality** | **Description** |
| --- | --- | --- | --- |
| <span id="element-id"></span>`id` | [string](/fhir-elements/primitive/string) | `0..1` | Logical id of this artifact |
| <span id="element-meta"></span>`meta` | [Meta](/fhir-elements/complex/meta) | `0..1` | Metadata about the resource |
| <span id="element-implicit-rules"></span>`implicitRules` | [uri](/fhir-elements/primitive/uri) | `0..1` | A set of rules under which this content was created |
| <span id="element-language"></span>`language` | [code](/fhir-elements/primitive/code) | `0..1` | Language of the resource content |
| <span id="element-text"></span>`text` | [Narrative](/fhir-elements/complex/narrative) | `0..1` | Text summary of the resource, for human interpretation |
| <span id="element-contained"></span>`contained` | [Resource](/fhir-elements/foundation/resource) | `0..*` | Contained, inline Resources |
| <span id="element-extension"></span>`extension` | [Extension](/fhir-elements/complex/extension) | `0..*` | Additional content defined by implementations |
| <span id="element-modifier-extension"></span>`modifierExtension` | [Extension](/fhir-elements/complex/extension) | `0..*` | Extensions that cannot be ignored |
| <span id="element-identifier"></span>`identifier` | [Identifier](/fhir-elements/complex/identifier) | `0..*` | Business identifier for this product. Could be an MPID |
| <span id="element-type"></span>`type` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..1` | Regulatory type, e.g. Investigational or Authorized |
| <span id="element-domain"></span>`domain` | [Coding](/fhir-elements/complex/coding) | `0..1` | If this medicine applies to human or veterinary uses |
| <span id="element-combined-pharmaceutical-dose-form"></span>`combinedPharmaceuticalDoseForm` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..1` | The dose form for a single part product, or combined form of a multiple part product |
| <span id="element-legal-status-of-supply"></span>`legalStatusOfSupply` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..1` | The legal status of supply of the medicinal product as classified by the regulator |
| <span id="element-additional-monitoring-indicator"></span>`additionalMonitoringIndicator` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..1` | Whether the Medicinal Product is subject to additional monitoring for regulatory reasons |
| <span id="element-special-measures"></span>`specialMeasures` | [string](/fhir-elements/primitive/string) | `0..*` | Whether the Medicinal Product is subject to special measures for regulatory reasons |
| <span id="element-paediatric-use-indicator"></span>`paediatricUseIndicator` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..1` | If authorised for use in children |
| <span id="element-product-classification"></span>`productClassification` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..*` | Allows the product to be classified by various systems |
| <span id="element-marketing-status"></span>`marketingStatus` | [MarketingStatus](/fhir-elements/complex/marketing-status) | `0..*` | Marketing status of the medicinal product, in contrast to marketing authorizaton |
| <span id="element-pharmaceutical-product"></span>`pharmaceuticalProduct` | [Reference](/fhir-elements/complex/reference) | `0..*` | Pharmaceutical aspects of product |
| <span id="element-packaged-medicinal-product"></span>`packagedMedicinalProduct` | [Reference](/fhir-elements/complex/reference) | `0..*` | Package representation for the product |
| <span id="element-attached-document"></span>`attachedDocument` | [Reference](/fhir-elements/complex/reference) | `0..*` | Supporting documentation, typically for regulatory submission |
| <span id="element-master-file"></span>`masterFile` | [Reference](/fhir-elements/complex/reference) | `0..*` | A master file for to the medicinal product (e.g. Pharmacovigilance System Master File) |
| <span id="element-contact"></span>`contact` | [Reference](/fhir-elements/complex/reference) | `0..*` | A product specific contact, person (in a role), or an organization |
| <span id="element-clinical-trial"></span>`clinicalTrial` | [Reference](/fhir-elements/complex/reference) | `0..*` | Clinical trials or studies that this product is involved in |
| <span id="element-name"></span>`name` | [BackboneElement](/fhir-elements/complex/backbone-element) | `1..*` | The product's name, including full name and possibly coded parts |
| <span id="element-cross-reference"></span>`crossReference` | [Identifier](/fhir-elements/complex/identifier) | `0..*` | Reference to another product, e.g. for linking authorised to investigational product |
| <span id="element-manufacturing-business-operation"></span>`manufacturingBusinessOperation` | [BackboneElement](/fhir-elements/complex/backbone-element) | `0..*` | An operation applied to the product, for manufacturing or adminsitrative purpose |
| <span id="element-special-designation"></span>`specialDesignation` | [BackboneElement](/fhir-elements/complex/backbone-element) | `0..*` | Indicates if the medicinal product has an orphan designation for the treatment of a rare disease |

## Resource-specific search parameters [#resource-specific-search-parameters]

| **Parameter** | **Type** | **Description** |
| --- | --- | --- |
| `identifier` | token | Business identifier for this product. Could be an MPID |
| `name` | string | The full product name |
| `name-language` | token | Language code for this name |

## Reference [#reference]

Official FHIR R4 spec: [MedicinalProduct](https://hl7.org/fhir/R4/medicinalproduct.html).  
Maturity: Draft (FMM 0).
