Sandbox Data

Overview

A sandbox environment containing simulated CGM data is available for all Registered Developers to test their applications. The data in the sandbox emulates real Dexcom data, and all the endpoints available in the production environment are also available in the sandbox environment.

Usage

To target the sandbox environment, use https://sandbox-api.dexcom.com as the base URL for requests. Because all requests require user authentication through OAuth 2.0, you will need to go through the process detailed in the Authentication section to access user data in the sandbox. When the login screen is presented during Step Two of the process, no password is required for the sandbox environment.

The sandbox environment is intended as a resource to enable new developers to start working with the Dexcom API immediately. With these simulated users, you can get up and running without requiring access to or authorization from a live Dexcom user account. This can help with understanding how to request, process, store, and use data; developing a user experience around the account connection flow; building and iterating on UI elements that utilize CGM data; and many other product development tasks.

Sandbox data is subject to some limitations. It is not guaranteed to be identical to production data (see below for some known differences) and does not cover all possible states and edge cases. It is also not guaranteed to be permanent, and the users and data may be updated or removed in the future. As such, this data should not be used for formal testing or validation, nor for training algorithms.

Data Description

Below are some details on the data available for these users:

  • Glucose, event, and calibration data repeats every sensor session (10 days).
  • Insulin and carb events have been populated for all users.
  • Phone data uploads “continuously”—that is, according to standard G6, G7, Dexcom ONE and Dexcom ONE+ mobile app upload schedules.
  • Receiver data uploads once per sensor session, at the end of the session.
  • There are instances of backfill, signal loss, and other non-nominal states.
  • Given the prevalence of the system, two simulated G6 Mobile App users are provided for data variety.

While we aspire to make the simulated data as close to production data as possible, there are some differences to be aware of when using the sandbox.

  • As mentioned above, the authorization flow is slightly different, with a drop-down menu instead of a username and password login.
  • If you go through the connection a second time with the same sandbox user, you will be presented with the HIPAA consent page again— this is not presented for already-consented users in production.
  • Since there is no access to account management for the sandbox users, you cannot revoke consent as a production user is able to.
  • The authorization code sent back with the redirect URI is static for each sandbox user, which is not the case in production.
  • The sandbox users do not experience time zone changes.

Users

The following simulated users can be accessed in the sandbox environment. The date range of available data is different for each user; use the /dataRange endpoint to determine what each sandbox user account has.

Username Data Description
User7 G7 Mobile App
User8 ONE+ Mobile App
User6 G6 Mobile App
User4 G6 Touchscreen Receiver