Search Usage Session entities by filter
Returns list of Usage Session, the response can be filtered, sorted and supports pagination
For more information and examples on creating search requests, click here.
Filter
Each additionalProp can filter one field, inside additionalProp there are many optional conditions that can be used for filtering that field
By using the logical additionalProps $AND, $OR, $NOT, you can add complex nested logic filters. When sending these props, you must send only the nested filter field inside the filter value. This will allow you to group additional filters using logical AND/OR/NOT operators. When not sending a logic prop (including when not sending a nested logic prop), the props are bundled together using logical AND operators, this means that only the items that match all filter conditions for that field will be returned.
filter items possible values: [ _templateId,_templateName,_id,_patient.id,_device.id,_startTime,_endTime,_initiator,_state,_ownerOrganization.id,_requiredMeasurementIntervalMilliseconds,_summary._stopReason,_summary._stopReasonCode,_name,_creationTime,_lastModifiedTime ] and all custom attributes of all templates
Sort
Results can be sorted by multiple fields, the order of the fields in the sort request governs the hierarchy of the sort
The first field is the primary sort, the second is used when two values of the first field are the same, and so forth
sort.order default value is DESC
sort.prop possible values:[ _id,_patient.id,_device.id,_startTime,_endTime,_initiator,_state,_ownerOrganization.id,_requiredMeasurementIntervalMilliseconds,_summary._stopReason,_summary._stopReasonCode,_name,_creationTime,_lastModifiedTime ]
If sort was not specified, the result will be sorted by: _creationTime DESC
Free text search
When freeTextSearch is passed, the free text search will be performed on every field except those of type Date
If used together with filters, freeTextSearch will be bundled to the filters with the logical AND operator, this means that only items that match all filters (and each filter's conditions) and the free text search will be returned
Page
limit max number of results that will be returned for each page. If not specify, the default will be 100
page page number starting from 0. If not specify, the default will be 0
Build URL
Encode the JSON object and use the encoded string as the searchRequest parameter:
https://<URL>?searchRequest=<ENCODED_JSON_STRING>
Query Parameters:
Parameter | Type | Mandatory | Description | Example |
---|---|---|---|---|
searchRequest | false | Search request parameters: filter, sort and page |
This API requires PROTECTED_API permission(s).