GET /events

Description

The /events endpoint enables retrieval of a user's event records. This includes carbohydrate intake, insulin doses, exercise, and health events that are entered in the receiver interface or through the mobile app.

Resource

GET /v2/users/self/events

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/events?startDate=2017-06-16T17:00:00&endDate=2017-06-16T21: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 GetDevices()
    {
      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/events?startDate=2017-06-16T17:00:00&endDate=2017-06-16T21: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/events?startDate=2017-06-16T17:00:00&endDate=2017-06-16T21: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/events?startDate=2017-06-16T17:00:00&endDate=2017-06-16T21: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/events?startDate=2017-06-16T17:00:00&endDate=2017-06-16T21: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/events?startDate=2017-06-16T17:00:00&endDate=2017-06-16T21: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/events?startDate=2017-06-16T17:00:00&endDate=2017-06-16T21: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/events?startDate=2017-06-16T17:00:00&endDate=2017-06-16T21: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/events?startDate=2017-06-16T17:00:00&endDate=2017-06-16T21: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/events?startDate=2017-06-16T17:00:00&endDate=2017-06-16T21: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

{
  "events": [
    {
      "systemTime": "2018-02-29T20:59:33",
      "displayTime": "2018-02-29T12:59:33",
      "eventType": "carbs",
      "eventSubType": null,
      "value": 35,
      "unit": "grams",
      "eventId": "601620ec-8caf-4244-81ff-cd946669806e",
      "eventStatus": "created"
    },
    {
      "systemTime": "2018-02-29T20:59:04",
      "displayTime": "2018-02-29T12:59:04",
      "eventType": "insulin",
      "eventSubType": "longActing",
      "value": 17,
      "unit": "units",
      "eventId": "4b790d7c-542e-4673-b1c4-92e4d8d4550a",
      "eventStatus": "created"
    },
    {
      "systemTime": "2018-02-29T20:58:53",
      "displayTime": "2018-02-29T12:58:53",
      "eventType": "insulin",
      "eventSubType": "fastActing",
      "value": 2.5,
      "unit": "units",
      "eventId": "a46b5c18-5fbd-4bb4-bcfc-5c9582eede9c",
      "eventStatus": "created"
    }
    {
      "systemTime": "2018-02-29T20:58:37",
      "displayTime": "2018-02-29T12:58:37",
      "eventType": "insulin",
      "eventSubType": "fastActing",
      "value": 2,
      "unit": "units",
      "eventId": "8705ff4c-e0d4-46a2-ad20-0839eafdfa32",
      "eventStatus": "deleted"
    }
  ]
}

Response Fields

Name	Type	Description
`events`	Array	Array of events

The events array fields are as follows

Name	Type	Description	Enumeration
`systemTime`	DateTime	Time according to the system clock for the event; nominally UTC
`displayTime`	DateTime	Time displayed on the receiving device for the event
`eventType`	String	Name of the event	"carbs" "insulin" "exercise" "health"
`eventSubType`	String	Additional event description corresponding to `eventType` field (nullable)	for `eventType` "carbs": null for `eventType` "insulin": "fastActing" "longActing" null for `eventType` "exercise": "light" "medium" "heavy" null for `eventType` "health": "illness" "stress" "highSymptoms" "lowSymptoms" "cycle" "alcohol" null
`value`	Float	Value of input (nullable)
`unit`	String	Unit of measurement for the `value` field (nullable)	for `eventType` "carbs": "grams" for `eventType` "insulin": "units" for `eventType` "exercise": "minutes" for `eventType` "health": null
`eventId`	String	Unique ID for the event record
`eventStatus`	String	Status of the event record See the Notes section below for more details	"created" "deleted"

Notes

The G6 app enabled the ability to delete events after they have been created. To accomodate this, the eventId and eventStatus fields were introduced. When an event is initially created by the user, the eventStatus is set to "created". If the user deletes the event, the eventStatus will be changed to "deleted". The eventId will remain the same.

For events generated by receiving devices that do not have the ability to delete events (such as the G4 and G5 apps), the eventStatus field will always return "created".

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