GET /calibrations

Description

The /calibrations endpoint enables retrieval of a user's calibration events. Calibration events are where the user enters the glucose value that they obtain from testing a fingerstick blood sample with their blood glucose meter into the CGM. These readings are used as a reference point for calculating EGV from the sensor signal.

Scopes & Access

 

Resource

GET /v2/users/self/calibrations

 

Authorization

OAuth 2.0 bearer token; see the Authentication section for details on this workflow.

 

Query Parameters

These query parameters specify the time window for the requested data; both are required. See the discussion of time in the Endpoint Overview section for more details on how they relate to device information.

Name

Type

Description

startDate

DateTime

Beginning of the time window

endDate

DateTime

End of the time window

 

Request Example

 

Response Example

{
  "calibrations": [
    {
      "systemTime": "2017-06-17T03:59:11",
      "displayTime": "2017-06-16T19:59:11",
      "unit": "mg/dL",
      "value": 124
    },
    {
      "systemTime": "2017-06-16T16:03:28",
      "displayTime": "2017-06-16T08:03:28",
      "unit": "mg/dL",
      "value": 86
    }
  ]
}

 

 

Response Fields

Name

Type

Description

calibrations

Array

Array of calibrations

 

The calibrations array fields are as follows
 

Name

Type

Description

Enumeration

systemTime

DateTime

Time according to the system clock at which calibration was entered; nominally UTC

 

displayTime

DateTime

Time displayed on the receiving device when the calibration was entered

 

value

Float

Calibration value entered by the user

 

unit

String

Unit of measurement for value

  • "mg/dL"
  • "mmol/L"

 

Notes

The documentation for an earlier version of this endpoint is available here.