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

 

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)

 

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