GET /dataRange

Description

The /dataRange endpoint enables retrieval of a user's earliest and latest times for calibration, EGV, and event records. This can be used to efficiently pull historical data and determine whether new data is available.

Resource

GET /v2/users/self/dataRange

Authorization

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

Query Parameters

No query parameters are required for this endpoint.

Request Example

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

curl -X GET \
  'https://api.dexcom.com/v2/users/self/dataRange' \
  -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 GetEGV()
    {
        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/dataRange";
        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/dataRange"

	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/dataRange")
  .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/dataRange");
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/dataRange",
  "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/dataRange",
  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/dataRange", 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/dataRange")

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/dataRange")! 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)
    if (data != nil){
                let responseData:String! = String(data: data!, encoding: String.Encoding.utf8)
                print(responseData)
            }
  }
})

dataTask.resume()

Response Example

{
  "calibrations":
  {
    "start":
    {
      "systemTime": "2015-12-13T22:57:30",
      "displayTime": "2015-12-13T14:57:30"
    },
    "end":
    {
      "systemTime": "2018-01-23T20:22:45",
      "displayTime": "2018-01-23T12:22:45"
    }
  },
  "egvs":
  {
    "start":
    {
      "systemTime": "2015-12-13T22:59:17",
      "displayTime": "2012-12-13T14:59:17"
    },
    "end":
    {
      "systemTime": "2018-01-27T17:42:25",
      "displayTime": "2018-01-27T09:42:25"
    }
  },
  "events": null
}

Response Fields

Name	Type	Description
`calibrations`	Object	Set of dates and times bounding the user's historical calibration records (nullable)
`egvs`	Object	Set of dates and times bounding the user's historical EGV records (nullable)
`events`	Object	Set of dates and times bounding the user's historical event records (nullable)

Name

Type

Description

calibrations

Object

Set of dates and times bounding the user's historical calibration records

(nullable)

egvs

Object

Set of dates and times bounding the user's historical EGV records

(nullable)

events

Object

Set of dates and times bounding the user's historical event records

(nullable)

The calibrations, egvs, and events object fields are as follows

Name	Type	Description
`start`	Object	The earliest records available for the specified dataset
`end`	Object	The latest records available for the specified dataset

The start and end object fields are as follows

Name	Type	Description
`systemTime`	DateTime	Time according to the system clock; nominally UTC
`displayTime`	DateTime	Time displayed on the receiving device