Skip to content
Tidepool API/Data API/
/
Start Time

Data API (1.0)

The Tidepool API is an HTTP REST API used by Tidepool clients use to communicate with the Tidepool Platform.

For more information, see the Getting Started section.

Download OpenAPI description
data.v1.json
data.v1.yaml
Overview
URL

https://support.tidepool.org/

Tidepool API Support

support@tidepool.org

License

BSD-2-Clause

Terms of Service

Languages
Servers
Mock server

https://tidepool.redocly.app/_mock/reference/data.v1/

integration

https://external.integration.tidepool.org/

production

https://api.tidepool.org/

dev1

https://dev1.dev.tidepool.org/

qa1

https://qa1.development.tidepool.org/

qa2

https://qa2.development.tidepool.org/

Internal

APIs intended for internal use by Tidepool.

Operations

Data

Manages diabetes data in user's Tidepool account.

Operations

Blood Glucose for Dosing Decision

A simple blood glucose for a dosing decision.

timestring(date-time)
valueBlood Value (mg/dL) (integer) or Blood Value (mmol/L) (number)(Blood Value (in mg/dL or mmol/L units))required
One of:

An integer value representing a mg/dL value.

[ 0 .. 1000 ]
integer(int32)(Blood Value (mg/dL))[ 0 .. 1000 ]

An integer value representing a mg/dL value.

{
  "time": "2019-08-24T14:15:22Z",
  "value": 105
}

Start Time

Start time as millisecond offset from midnight

startnumber[ 0 .. 86400000 ]required
{
  "start": 86400000
}

Blood Glucose Target Start

Start time as millisecond offset from midnight

One of:

Blood glucose target values, in mg/dL

highnumber[ 0 .. 1000 ]

An integer encoding the upper bound of a PWD's blood glucose target.

The minimum value should be >= low or target, whichever present

Example: 180
lownumber[ 0 .. 1000 ]

An integer encoding the lower bound of a PWD's blood glucose target.

Example: 80
rangenumber[ 0 .. 1000 ]

An integer encoding the allowed deviation above or below the PWD's target blood glucose.

Maximum should be min(target, 1000 - target) such that target-range >= 0 and target+range <= 1000

targetnumber[ 0 .. 1000 ]

An integer encoding the PWD's target blood glucose as a single value.

startnumber[ 0 .. 86400000 ]required
{
  "high": 180,
  "low": 80
}