# DeviceUseStatement

Canonical page: https://docs.ovok.com/api/fhir/r4/device-use-statement

A record of a device being used by a patient where the record is the result of a report from the patient or another clinician.

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/DeviceUseStatement/[id]` |
| Vread | `GET` | `/fhir/R4/DeviceUseStatement/[id]/_history/[vid]` |
| Update | `PUT` | `/fhir/R4/DeviceUseStatement/[id]` |
| Patch | `PATCH` | `/fhir/R4/DeviceUseStatement/[id]` |
| Delete | `DELETE` | `/fhir/R4/DeviceUseStatement/[id]` |
| Create | `POST` | `/fhir/R4/DeviceUseStatement` |
| Search | `GET` | `/fhir/R4/DeviceUseStatement` |
| History | `GET` | `/fhir/R4/DeviceUseStatement/[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..*` | External identifier for this record |
| <span id="element-based-on"></span>`basedOn` | [Reference](/fhir-elements/complex/reference) | `0..*` | Fulfills plan, proposal or order |
| <span id="element-status"></span>`status` | [code](/fhir-elements/primitive/code) | `1..1` | active \| completed \| entered-in-error + |
| <span id="element-subject"></span>`subject` | [Reference](/fhir-elements/complex/reference) | `1..1` | Patient using device |
| <span id="element-derived-from"></span>`derivedFrom` | [Reference](/fhir-elements/complex/reference) | `0..*` | Supporting information |
| <span id="element-timing-x"></span>`timing[x]` | [Timing](/fhir-elements/complex/timing), [Period](/fhir-elements/complex/period), [dateTime](/fhir-elements/primitive/date-time) | `0..1` | How often  the device was used |
| <span id="element-recorded-on"></span>`recordedOn` | [dateTime](/fhir-elements/primitive/date-time) | `0..1` | When statement was recorded |
| <span id="element-source"></span>`source` | [Reference](/fhir-elements/complex/reference) | `0..1` | Who made the statement |
| <span id="element-device"></span>`device` | [Reference](/fhir-elements/complex/reference) | `1..1` | Reference to device used |
| <span id="element-reason-code"></span>`reasonCode` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..*` | Why device was used |
| <span id="element-reason-reference"></span>`reasonReference` | [Reference](/fhir-elements/complex/reference) | `0..*` | Why was DeviceUseStatement performed? |
| <span id="element-body-site"></span>`bodySite` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..1` | Target body site |
| <span id="element-note"></span>`note` | [Annotation](/fhir-elements/complex/annotation) | `0..*` | Addition details (comments, instructions) |

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

| **Parameter** | **Type** | **Description** |
| --- | --- | --- |
| `device` | reference | Search by device |
| `identifier` | token | Search by identifier |
| `patient` | reference | Multiple Resources: AllergyIntolerance: Who the sensitivity is for ; CarePlan: Who the care plan is for ; CareTeam: Who care team is for ; ClinicalImpression: Patient or group assessed ; Composition: Who and/or what the composition is about ; Condition: Who has the condition? ; Consent: Who the consent applies to ; DetectedIssue: Associated patient ; DeviceRequest: Individual the service is ordered for ; DeviceUseStatement: Search by subject - a patient ; DiagnosticReport: The subject of the report if a patient ; DocumentManifest: The subject of the set of documents ; DocumentReference: Who/what is the subject of the document ; Encounter: The patient or group present at the encounter ; EpisodeOfCare: The patient who is the focus of this episode of care ; FamilyMemberHistory: The identity of a subject to list family member history items for ; Flag: The identity of a subject to list flags for ; Goal: Who this goal is intended for ; ImagingStudy: Who the study is about ; Immunization: The patient for the vaccination record ; List: If all resources have the same subject ; MedicationAdministration: The identity of a patient to list administrations  for ; MedicationDispense: The identity of a patient to list dispenses  for ; MedicationRequest: Returns prescriptions for a specific patient ; MedicationStatement: Returns statements for a specific patient. ; NutritionOrder: The identity of the person who requires the diet, formula or nutritional supplement ; Observation: The subject that the observation is about (if patient) ; Procedure: Search by subject - a patient ; RiskAssessment: Who/what does assessment apply to? ; ServiceRequest: Search by subject - a patient ; SupplyDelivery: Patient for whom the item is supplied ; VisionPrescription: The identity of a patient to list dispenses for  |
| `subject` | reference | Search by subject |

## Reference [#reference]

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