An instance of a manufactured device that is used in the provision of healthcare
Retrieving a patient’s implantable devices/UDI
The logical ID of the patient to retrieve is passed as part of the URL. The logical ID is found as the result of a search.
GET https://tw171.open.allscripts.com/FHIR/Patient/id/Device
GET https://tw171.open.allscripts.com/FHIR/Patient/id/Device?date=eq2016-01-01
| Name | Required? | Type | Description |
|---|---|---|---|
| id | yes | URL | The logical ID of the patient. This is retrieved using the search function. |
| date | no | string | A string representing a date to include in the search. See below for more information. |
A DAF Device is returned.
| Name | Type | Cardinality | Description |
|---|---|---|---|
| identifier | 0..* | Unique instance identifier assigned to a device by organizations like manufacturers or owners. If the identifier indicates the type of device, Device.type should be used. This is a business identifier, not a resource identifier, often fixed to the device as a barcode, and may include names given to the device in local usage. Note that some of the barcodes affixed to the device identify its type, not its instance. For the FDA mandated Unique Device Identifier (UDI), use the Device.udi element. | |
| type | CodeableConcept | 1..1 | Code or identifier to indicate a kind of device. For the FDA mandated Unique Device Identifier (UDI), use the Device.udi element. |
| note | Annotation | 0..* | Device notes and comments, including annotations. |
| status | code | 0..1 | Status of the device availability. This value set has an inline system that defines the following codes: Available, Not Available, and Entered-in-Error. For more information on this value set, see devicestatus. |
| manufacturer | string | 0..1 | Name of device manufacturer. |
| model | string | 0..1 | Model ID assigned by the manufacturer. |
| version | string | 0..1 | Version number. For example, software. |
| manufactureDate | dateTime | 0..1 | Manufacture date. |
| expiry | dateTime | 0..1 | Date and time of expiration of this device, if applicable. |
| udi | string | 0..1 | FDA mandated Unique Device Identifier. |
| lotNumber | string | 0..1 | Lot number of manufacturer. |
| owner | Reference(Organization) | 0..1 | Organization responsible for device. |
| location | Reference(Location) | 0..1 | Where the resource is found. |
| patient | Reference(Patient) | 0..1 | If the resource is affixed to a person. |
| contact | ContactPoint | 0..* | Details for human/organization for support. |
| url | URI | 0..1 | Network address to contact device. |
Searching by Date
Dates are passed as query paramters on the URL. Since the URL parameters cannot handle comparators (for example, >, <=) these are passed as pat of the date.
date=eq2016-01-01
date=gt2016-01-01
The following comparators are supported:
| Comparator | Description |
|---|---|
| eq | equal |
| gt | greater than |
| ge | greater than or equal |
| lt | less than |
| le | less than or equal |
To search for a date range, pass in the date twice.
date=ge2010-01-01&date=le2010-12-31
This search would include every day in the year 2010.