GET /dataRange

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.

SecurityBearerAuth
Responses
200

Ok

Response Schema: application/json
object

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

object

The earliest records available for the specified dataset

systemTime
string <date-time>

Time according to the system clock; nominally UTC

displayTime
string <date-time>

Time displayed on the receiving device

object

The latest records available for the specified dataset

systemTime
string <date-time>

Time according to the system clock; nominally UTC

displayTime
string <date-time>

Time displayed on the receiving device

object

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

object

The earliest records available for the specified dataset

systemTime
string <date-time>

Time according to the system clock; nominally UTC

displayTime
string <date-time>

Time displayed on the receiving device

object

The latest records available for the specified dataset

systemTime
string <date-time>

Time according to the system clock; nominally UTC

displayTime
string <date-time>

Time displayed on the receiving device

object

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

object

The earliest records available for the specified dataset

systemTime
string <date-time>

Time according to the system clock; nominally UTC

displayTime
string <date-time>

Time displayed on the receiving device

object

The latest records available for the specified dataset

systemTime
string <date-time>

Time according to the system clock; nominally UTC

displayTime
string <date-time>

Time displayed on the receiving device

get/v2/users/self/dataRange
Request samples
curl -i -X GET \
  https://api.dexcom.com/v2/users/self/dataRange \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'
Response samples
application/json
{
  • "calibrations": {
    • "start": {
      • "systemTime": "2023-01-01T09:12:35",
      • "displayTime": "2023-01-01T09:12:35"
      },
    • "end": {
      • "systemTime": "2023-01-01T09:12:35",
      • "displayTime": "2023-01-01T09:12:35"
      }
    },
  • "egvs": {
    • "start": {
      • "systemTime": "2023-01-01T09:12:35",
      • "displayTime": "2023-01-01T09:12:35"
      },
    • "end": {
      • "systemTime": "2023-01-01T09:12:35",
      • "displayTime": "2023-01-01T09:12:35"
      }
    },
  • "events": {
    • "start": {
      • "systemTime": "2023-01-01T09:12:35",
      • "displayTime": "2023-01-01T09:12:35"
      },
    • "end": {
      • "systemTime": "2023-01-01T09:12:35",
      • "displayTime": "2023-01-01T09:12:35"
      }
    }
}