DeviceUseStatement

The FHIR R4 DeviceUseStatement resource is used to capture details about the use of a medical device for a patient. It records the context, reason, and time of device usage and provides valuable information about the medical devices prescribed or used in a patient's care.

Use Cases

  • Record medical device usage during care
  • Document device usage for compliance
  • Retrieve historical device data for outcomes
  • Update device usage during follow-ups
  • Integrate device data into care workflows

Base URLs

Authentication

All requests require OAuth 2.0 authentication using a Bearer Token. Unauthorized requests return 401 Unauthorized responses.

Required scopes:

  • deviceusestatement.read for GET
  • deviceusestatement.write for POST, PUT, DELETE

For more information, go to: OAuth 2.0 Authentication.

Supported Methods

MethodOperationDescription
GETRead DeviceUseStatementRetrieves a specific DeviceUseStatement record by its FHIR ID.
GETSearch DeviceUseStatementSearches for DeviceUseStatement records for a specified patient.
POSTCreate DeviceUseStatementSubmits a new DeviceUseStatement record to the Health Gorilla FHIR server.
PUTUpdate DeviceUseStatementUpdates an existing DeviceUseStatement record by full resource replacement.
DELETEDelete DeviceUseStatementRemoves an existing DeviceUseStatement record from the system.

Frequently Used Search Parameters

ParameterDescriptionFHIR Value Set / Example ValuesFHIR Data TypeRequired
patientFilters by patient IDPatient/{id}ReferenceYes
deviceFilters by device usedDevice/{id}ReferenceNo
statusFilters by status of device use (e.g., active, completed)DeviceUseStatementStatus (active)tokenNo
dateFilters by date of device usege2024-01-01, le2024-12-31`date

Webhooks

Clients can subscribe to receive notifications when new device use statements are recorded, or when existing statements are updated or resolved. For more information, go to: Webhooks & Polling.

Error Handling

All DeviceUseStatement operations follow standard Health Gorilla error handling, including use of FHIR OperationOutcome for structured responses. For more information, go to: Error Handling.

Additional Resources

HL7 FHIR DeviceUseStatement