Skip to content
Documentation
/
/
/
Combination Bolus (`combi...
Last updated

Combination Bolus (combination)

Quick Summary

annotationsArray of Annotation (object) or Blood Glucose Out of Range (object)(Annotation Array)[ 0 .. 100 ] itemsunique

An array of annotations.

archivedTimestring(date-time)(Date/Time)read-only
Example: "2017-02-06T02:37:46Z"
archivedDatasetIdstring(Data Set ID)[ 17 .. 37 ] characters^(upid_[0-9a-f]{12}|upid_[0-9a-f]{32}|[0-9a-f...
Example: "ce8cc5f7595575945f91fc6710db6fef"
associationsArray of Association (blob) (object) or Association (datum) (object) or Association (image) (object) or Association (url) (object)(Association Array)

An array of associations for the resource.

clockDriftOffsetinteger(int64)(Clock Drift Offset)[ -86400000 .. 86400000 ]

Clock drift offset, expressed as milliseconds.

Example: 0
conversionOffsetinteger(int64)(Conversion Offset)

Conversion offset, expressed as milliseconds.

Example: 0
createdTimestring(date-time)(Date/Time)
Example: "2017-02-06T02:37:46Z"
createdUserIdstring(Tidepool User ID)^([0-9a-f]{10}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-...read-only

String representation of a Tidepool User ID. Old style IDs are 10-digit strings consisting of only hexadeximcal digits. New style IDs are 36-digit UUID v4

deduplicatorobject(Deduplicator Descriptor)
deletedTimestring(date-time)(Date/Time)
Example: "2017-02-06T02:37:46Z"
deletedUserIdstring(Tidepool User ID)^([0-9a-f]{10}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-...read-only

String representation of a Tidepool User ID. Old style IDs are 10-digit strings consisting of only hexadeximcal digits. New style IDs are 36-digit UUID v4

deviceIdstring(Device ID)non-empty

Globally unique to device and repeatable with each upload, e.g. device make and model with serial number

Example: "MMT-1711:12345678"
deviceTimestring(Date/Time without Timezone)^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$
Example: "2017-02-06T02:37:46"
historyArray of objects(Event History [Proposed])

Revision history of the event

idstring(Data Set ID)[ 17 .. 37 ] characters^(upid_[0-9a-f]{12}|upid_[0-9a-f]{32}|[0-9a-f...required
Example: "ce8cc5f7595575945f91fc6710db6fef"
locationobject(Location)

Location information associated with the resource. One or both of name and gps must be specified.

modifiedTimestring(date-time)(Date/Time)
Example: "2017-02-06T02:37:46Z"
modifiedUserIdstring(Tidepool User ID)^([0-9a-f]{10}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-...read-only

String representation of a Tidepool User ID. Old style IDs are 10-digit strings consisting of only hexadeximcal digits. New style IDs are 36-digit UUID v4

notesArray of strings(Note Array)[ 1 .. 100 ] items

An array of 1 to 100 notes.

originobject(Origin)

External origin information for the source of the resource.

payloadobject(Payload)

Grab bag field for data that isn't yet part of the data model. The maximum size is 4K bytes.

sourcestring
Value"carelink"
tagsArray of strings(Tag Array)

An array of tags.

timestring(date-time)(Date/Time)required
Example: "2017-02-06T02:37:46Z"
timezonestring(Time Zone)
Example: "Europe/London"
timezoneOffsetinteger(int32)(Time Zone offset)[ -10080 .. 10080 ]

Time zone offset, expressed as positive or negative number of minutes from UTC.

Example: -420
typestring(Tidepool Data Type)required

Data type

Enum"bolus""alert""basal""bloodKetone""cbg""cgmSettings""controllerSettings""controllerStatus""deviceEvent""deviceStatus"
Example: "upload"
uploadIdstring(Upload ID)[ 17 .. 32 ] characters^([0-9a-f]{32}|upid_[0-9a-f]{12})$

An upload identifier; this field should be the uploadId of the corresponding upload record

Example: "0d92d5c1c22117a18f3620b9e24d3c06"
subTypestring(Bolus Subtype)required
Enum"dual/square""automated""normal""square"
insulinFormulationInsulin Formulation (object)(Insulin Formulation)
One of:
deliveryContextstring(Bolus Delivery Context)
Enum"algorithm""device""oneButton""remote""watch""undetermined"
durationinteger(int64)[ 0 .. 86400000 ]required

Integer value representing milliseconds

expectedDurationinteger(int64)[ 0 .. 86400000 ]

Integer value representing milliseconds

expectedExtendednumber(float)[ 0 .. 100 ]

Floating point value rounded to the appropriate significant figures for the device's precision.

expectedNormalnumber(float)[ 0 .. 100 ]

Floating point value rounded to the appropriate significant figures for the device's precision.

extendednumber(float)[ 0 .. 100 ]required

Floating point value rounded to the appropriate significant figures for the device's precision.

normalnumber(float)[ 0 .. 100 ]required

Floating point value rounded to the appropriate significant figures for the device's precision.

guidstringDeprecated

A string ID. Added to each event during data processing in the Tidepool Uploader or upon ingestion by the platform data ingestion service.

Sub-Type (subType)

This is the sub-type of bolus event that represents a bolus insulin dose programmed to deliver part of the dose immediatley (a normal bolus) and the remainder delivered evenly over a duration of time (an extended bolus). Essentially, this sub-type is a combination of both normal and extended boluses.

Most insulin pumps ask the user to divide the normal and extended portions of a combination bolus by percentage of the total insulin dose. Tidepool does not save this percentage directly but it can be worked out by looking at the appropriate combination and sum of values (e.g. normal, extended, expected normal and expected extended fields).

Examples

Example (client)
{
    "type": "bolus",
    "subType": "dual/square",
    "normal": 6.25,
    "extended": 5.75,
    "expectedExtended": 8.625,
    "duration": 23400000,
    "expectedDuration": 35100000,
    "clockDriftOffset": 0,
    "conversionOffset": 0,
    "deviceId": "DevId0987654321",
    "deviceTime": "2018-05-14T18:17:07",
    "guid": "dc114f19-74fe-4075-9676-38faec7cf0cc",
    "id": "d184a41eaf984afcbe553071f80bcdec",
    "time": "2018-05-14T08:17:07.035Z",
    "timezoneOffset": 600,
    "uploadId": "SampleUploadId"
}
Example (ingestion)
{
    "type": "bolus",
    "subType": "dual/square",
    "normal": 9.25,
    "extended": 5.5,
    "expectedExtended": 8.25,
    "duration": 57600000,
    "expectedDuration": 86400000,
    "clockDriftOffset": 0,
    "conversionOffset": 0,
    "deviceId": "DevId0987654321",
    "deviceTime": "2018-05-14T18:17:07",
    "time": "2018-05-14T08:17:07.035Z",
    "timezoneOffset": 600,
    "uploadId": "SampleUploadId"
}
Example (storage)
{
    "type": "bolus",
    "subType": "dual/square",
    "normal": 2.25,
    "extended": 9.5,
    "expectedExtended": 14.25,
    "duration": 48600000,
    "expectedDuration": 72900000,
    "_active": true,
    "_groupId": "abcdef",
    "_schemaVersion": 0,
    "_version": 0,
    "clockDriftOffset": 0,
    "conversionOffset": 0,
    "createdTime": "2018-05-14T08:17:12.035Z",
    "deviceId": "DevId0987654321",
    "deviceTime": "2018-05-14T18:17:07",
    "guid": "cf850a7a-1f28-4bbc-8a56-36cbe0326f20",
    "id": "4f8b8b133b22401aa1f281be9eb954ad",
    "time": "2018-05-14T08:17:07.035Z",
    "timezoneOffset": 600,
    "uploadId": "SampleUploadId"
}

Keep Reading

Previous page
Next page