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.

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

curl
C#
Go
Java
JS
Node.js
PHP
Python
Ruby
Swift

curl -X GET \
  'https://api.dexcom.com/v2/users/self/calibrations?startDate=2017-06-16T08:00:00&endDate=2017-06-17T08:00:00' \
  -H 'authorization: Bearer {your_access_token}'

using System;
using System.Threading.Tasks;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

public class APIAccess
{
    string _baseUrl = "https://api.dexcom.com";
    string _token = "{your_access_token}";
    private void GetCalibrations()
    {
        var client = new HttpClient();
        client.DefaultRequestHeaders.Accept.Clear();
        client.DefaultRequestHeaders.Accept.Add(
        new MediaTypeWithQualityHeaderValue("application/json"));
        client.DefaultRequestHeaders.Add("authorization", "Bearer " + _token);
        var url = _baseUrl + "/v2/users/self/calibrations?startDate=2017-06-16T08:00:00&endDate=2017-06-17T08:00:00";
        HttpResponseMessage response = client.GetAsync(url).Result;
        Console.Write(response.Content.ReadAsStringAsync().Result);
    }
}

package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://api.dexcom.com/v2/users/self/calibrations?startDate=2017-06-16T08:00:00&endDate=2017-06-17T08:00:00"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("authorization", "Bearer {your_access_token}")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://api.dexcom.com/v2/users/self/calibrations?startDate=2017-06-16T08:00:00&endDate=2017-06-17T08:00:00")
  .get()
  .addHeader("authorization", "Bearer {your_access_token}")
  .build();

Response response = client.newCall(request).execute();

var data = null;

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.dexcom.com/v2/users/self/calibrations?startDate=2017-06-16T08:00:00&endDate=2017-06-17T08:00:00");
xhr.setRequestHeader("authorization", "Bearer {your_access_token}");

xhr.send(data);

var http = require("https");

var options = {
  "method": "GET",
  "hostname": "api.dexcom.com",
  "port": null,
  "path": "/v2/users/self/calibrations?startDate=2017-06-16T08:00:00&endDate=2017-06-17T08:00:00",
  "headers": {
    "authorization": "Bearer {your_access_token}",
    }
};

var req = http.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

<?php
$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.dexcom.com/v2/users/self/calibrations?startDate=2017-06-16T08:00:00&endDate=2017-06-17T08:00:00",
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => array(
    "authorization: Bearer {your_access_token}"
  ),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

import http.client

conn = http.client.HTTPSConnection("api.dexcom.com")

headers = {
    'authorization': "Bearer {your_access_token}",
    }

conn.request("GET", "/v2/users/self/calibrations?startDate=2017-06-16T08:00:00&endDate=2017-06-17T08:00:00", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.dexcom.com/v2/users/self/calibrations?startDate=2017-06-16T08:00:00&endDate=2017-06-17T08:00:00")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Bearer {your_access_token}'

response = http.request(request)
puts response.read_body

import Foundation

let headers = [
  "authorization": "Bearer {your_access_token}"
  ]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.dexcom.com/v2/users/self/calibrations?startDate=2017-06-16T08:00:00&endDate=2017-06-17T08:00:00")! as URL,
      cachePolicy: .useProtocolCachePolicy,
  timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()

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.