# AdverseEvent

Canonical page: https://docs.ovok.com/api/fhir/r4/adverse-event

Actual or potential/avoided event causing unintended physical injury resulting from or contributed to by medical care, a research study or other healthcare setting factors that requires additional monitoring, treatment, or hospitalization, or that results in death.

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/AdverseEvent/[id]` |
| Vread | `GET` | `/fhir/R4/AdverseEvent/[id]/_history/[vid]` |
| Update | `PUT` | `/fhir/R4/AdverseEvent/[id]` |
| Patch | `PATCH` | `/fhir/R4/AdverseEvent/[id]` |
| Delete | `DELETE` | `/fhir/R4/AdverseEvent/[id]` |
| Create | `POST` | `/fhir/R4/AdverseEvent` |
| Search | `GET` | `/fhir/R4/AdverseEvent` |
| History | `GET` | `/fhir/R4/AdverseEvent/[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..1` | Business identifier for the event |
| <span id="element-actuality"></span>`actuality` | [code](/fhir-elements/primitive/code) | `1..1` | actual \| potential |
| <span id="element-category"></span>`category` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..*` | product-problem \| product-quality \| product-use-error \| wrong-dose \| incorrect-prescribing-information \| wrong-technique \| wrong-route-of-administration \| wrong-rate \| wrong-duration \| wrong-time \| expired-drug \| medical-device-use-error \| problem-different-manufacturer \| unsafe-physical-environment |
| <span id="element-event"></span>`event` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..1` | Type of the event itself in relation to the subject |
| <span id="element-subject"></span>`subject` | [Reference](/fhir-elements/complex/reference) | `1..1` | Subject impacted by event |
| <span id="element-encounter"></span>`encounter` | [Reference](/fhir-elements/complex/reference) | `0..1` | Encounter created as part of |
| <span id="element-date"></span>`date` | [dateTime](/fhir-elements/primitive/date-time) | `0..1` | When the event occurred |
| <span id="element-detected"></span>`detected` | [dateTime](/fhir-elements/primitive/date-time) | `0..1` | When the event was detected |
| <span id="element-recorded-date"></span>`recordedDate` | [dateTime](/fhir-elements/primitive/date-time) | `0..1` | When the event was recorded |
| <span id="element-resulting-condition"></span>`resultingCondition` | [Reference](/fhir-elements/complex/reference) | `0..*` | Effect on the subject due to this event |
| <span id="element-location"></span>`location` | [Reference](/fhir-elements/complex/reference) | `0..1` | Location where adverse event occurred |
| <span id="element-seriousness"></span>`seriousness` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..1` | Seriousness of the event |
| <span id="element-severity"></span>`severity` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..1` | mild \| moderate \| severe |
| <span id="element-outcome"></span>`outcome` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..1` | resolved \| recovering \| ongoing \| resolvedWithSequelae \| fatal \| unknown |
| <span id="element-recorder"></span>`recorder` | [Reference](/fhir-elements/complex/reference) | `0..1` | Who recorded the adverse event |
| <span id="element-contributor"></span>`contributor` | [Reference](/fhir-elements/complex/reference) | `0..*` | Who  was involved in the adverse event or the potential adverse event |
| <span id="element-suspect-entity"></span>`suspectEntity` | [BackboneElement](/fhir-elements/complex/backbone-element) | `0..*` | The suspected agent causing the adverse event |
| <span id="element-subject-medical-history"></span>`subjectMedicalHistory` | [Reference](/fhir-elements/complex/reference) | `0..*` | AdverseEvent.subjectMedicalHistory |
| <span id="element-reference-document"></span>`referenceDocument` | [Reference](/fhir-elements/complex/reference) | `0..*` | AdverseEvent.referenceDocument |
| <span id="element-study"></span>`study` | [Reference](/fhir-elements/complex/reference) | `0..*` | AdverseEvent.study |

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

| **Parameter** | **Type** | **Description** |
| --- | --- | --- |
| `actuality` | token | actual \| potential |
| `category` | token | product-problem \| product-quality \| product-use-error \| wrong-dose \| incorrect-prescribing-information \| wrong-technique \| wrong-route-of-administration \| wrong-rate \| wrong-duration \| wrong-time \| expired-drug \| medical-device-use-error \| problem-different-manufacturer \| unsafe-physical-environment |
| `date` | date | When the event occurred |
| `event` | token | Type of the event itself in relation to the subject |
| `location` | reference | Location where adverse event occurred |
| `recorder` | reference | Who recorded the adverse event |
| `resultingcondition` | reference | Effect on the subject due to this event |
| `seriousness` | token | Seriousness of the event |
| `severity` | token | mild \| moderate \| severe |
| `study` | reference | AdverseEvent.study |
| `subject` | reference | Subject impacted by event |
| `substance` | reference | Refers to the specific entity that caused the adverse event |

## Reference [#reference]

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