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. Calibration Mobile App Screen

Resource

GET /v2/users/self/calibrations

Authorization

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

SecurityBearerAuth
Request
query Parameters
startDate
required
string <date-time>

Beginning of the time window; see the discussion of time in the Endpoint Overview section for more details on how they relate to device information

Example: startDate=2023-01-01T09:12:35
endDate
required
string <date-time>

End of the time window

Example: endDate=2023-01-01T09:12:35
Responses
200

Ok

Response Schema: application/json
Array of objects

Array of calibrations

Array
systemTime
string <date-time>

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

displayTime
string <date-time>

Time displayed on the receiving device when the calibration was entered

unit
string

Unit of measurement for value

Enum: "mg/dL" "mmol/L"
value
number <float>

Calibration value entered by the user

get/v2/users/self/calibrations
Request samples
curl -i -X GET \
  'https://api.dexcom.com/v2/users/self/calibrations?startDate=2023-01-01T09%3A12%3A35&endDate=2023-01-01T09%3A12%3A35' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'
Response samples
application/json
{
  • "calibrations": [
    • {
      • "systemTime": "2019-08-24T14:15:22Z",
      • "displayTime": "2019-08-24T14:15:22Z",
      • "unit": "mg/dL",
      • "value": 0
      }
    ]
}