GET /egvs

This page documents an old version of the endpoint. The newest version, v2, is documented here.

 

Description

The /egvs endpoint enables retrieval of a user's estimated glucose value (EGV) data, including trend and status information.

Scopes & Access

 

Resource

GET /v1/users/self/egvs

 

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

 

Response Example

{
  "unit": "mg/dL",
  "rateUnit": "mg/dL/min",
  "egvs": [
    {
      "systemTime": "2017-06-16T15:40:00",
      "displayTime": "2017-06-16T07:40:00",
      "value": 119,
      "status": null,
      "trend": "fortyFiveDown",
      "trendRate": -1.3
    },
    {
      "systemTime": "2017-06-16T15:35:00",
      "displayTime": "2017-06-16T07:35:00",
      "value": 126,
      "status": null,
      "trend": "fortyFiveDown",
      "trendRate": -1.2
    },
    {
      "systemTime": "2017-06-16T15:30:00",
      "displayTime": "2017-06-16T07:30:00",
      "value": 132,
      "status": null,
      "trend": "fortyFiveDown",
      "trendRate": -1.1
    }
  ]
}

 

 

Response Fields

Name

Type

Description

Enumeration

unit

String

Unit of measurement for value

  • "mg/dL"
  • "mmol/L"

rateUnit

String

Unit of measurement for trendRate

  • "mg/dL/min"
  • "mmol/L/min"

egvs

Array

Array of estimated glucose values

 
The egvs array fields are as follows
 

Name

Type

Description

Enumeration

systemTime

DateTime

Time according to the system clock at which observation was made; nominally UTC

 

displayTime

DateTime

Time displayed on the receiving device when the observation was made

 

value

Float

Estimated glucose value

  • 39
    indicates that the value was calculated and it was less than 40; the value 39 is used in calculations but is not explicitly displayed to end users
  • 40 to 400
    this is the measuring range of the Dexcom CGM
  • 401
    indicates that the value was calculated and it was greater than 400; the value 401 is used in calculations but is not explicitly displayed to end users

status

String

Explanation of EGV record; used when the value field is outside the measuring range

(nullable)

  • "high"
    indicates a glucose value of more than 400
  • "low"
    indicates a glucose value of less than 40

trend

String

General trend of EGV value movement; corresponds to trendRate field

(nullable)

  • "doubleUp"
    +3 ≤ trendRate ≤ +8
  • "singleUp"
    +2 ≤ trendRate < +3
  • "fortyFiveUp"
    +1 ≤ trendRate < +2
  • "flat"
    -1 < trendRate < +1
  • "fortyFiveDown"
    -2 < trendRate ≤ -1
  • "singleDown"
    -3 < trendRate ≤ -2
  • "doubleDown"
    -8 < trendRate ≤ -3
  • "none"
    no arrow (blank)
  • "notComputable"
    the algorithm decides that it is not reasonable to compute trend arrow
  • "rateOutOfRange"
    the computed filtered rate is not within the range for assigning the arrows

trendRate

Float

Rate at which glucose value is moving up or down

(nullable)