Skip to content
Tidepool API/Data API/
/
Device ID

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

Deduplicator Descriptor

hashstringnon-empty
versionstring(Semantic Version Number)>= 5 characters^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-...required

Semantic Version Number 2.0.0. Regex from their site.

Example: "2.36.1"
namestring(Reverse Domain Name)^[a-zA-Z0-9](|[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])(...required

Name in the reverse domain name notation.

Example: "org.tidepool.uploader"
{
  "hash": "string",
  "version": "2.36.1",
  "name": "org.tidepool.uploader"
}

Device ID

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

string(Device ID)non-empty

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

"MMT-1711:12345678"

Device Manufacturers

An array of string tags indicating the manufacturer(s) of the device.

In order to avoid confusion resulting from referring to a single manufacturer with more than one name—for example, using both 'Minimed' and 'Medtronic' interchangeably—we restrict the set of strings used to refer to manufacturers to the set listed above and enforce exact string matches (including casing).

deviceManufacturers is an array of one or more string "tags" because there are devices resulting from a collaboration between more than one manufacturer, such as the Tandem G4 insulin pump with CGM integration (a collaboration between Tandem and Dexcom).

Array [
string
]
[
  "DeviceCo"
]