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
- Production: <https://api.healthgorilla.com/fhir/R4/DeviceUseStatement>
- Sandbox: <https://sandbox.healthgorilla.com/fhir/R4/DeviceUseStatement>
Authentication
All requests require OAuth 2.0 authentication using a Bearer Token. Unauthorized requests return 401 Unauthorized responses.
Required scopes:
deviceusestatement.readfor GETdeviceusestatement.writefor POST, PUT, DELETE
For more information, go to: OAuth 2.0 Authentication.
Supported Methods
| Method | Operation | Description |
|---|---|---|
GET | Read DeviceUseStatement | Retrieves a specific DeviceUseStatement record by its FHIR ID. |
GET | Search DeviceUseStatement | Searches for DeviceUseStatement records for a specified patient. |
POST | Create DeviceUseStatement | Submits a new DeviceUseStatement record to the Health Gorilla FHIR server. |
PUT | Update DeviceUseStatement | Updates an existing DeviceUseStatement record by full resource replacement. |
DELETE | Delete DeviceUseStatement | Removes an existing DeviceUseStatement record from the system. |
Frequently Used Search Parameters
| Parameter | Description | FHIR Value Set / Example Values | FHIR Data Type | Required |
|---|---|---|---|---|
patient | Filters by patient ID | Patient/{id}` | Reference | Yes |
device | Filters by device used | Device/{id}` | Reference | No |
status | Filters by status of device use (e.g., active, completed) | DeviceUseStatementStatus (active) | token | No |
date | Filters by date of device use | ge2024-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.