{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/dexcom/refs/heads/main/json-schema/dexcom-api-events-response-schema.json",
  "title": "EventsResponse",
  "description": "EventsResponse schema from Dexcom Developer API",
  "type": "object",
  "properties": {
    "recordType": {
      "type": "string",
      "example": "event"
    },
    "recordVersion": {
      "type": "string",
      "example": "3.0"
    },
    "userId": {
      "type": "string"
    },
    "records": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/EventRecord"
      }
    }
  },
  "$defs": {
    "EventRecord": {
      "type": "object",
      "properties": {
        "recordId": {
          "type": "string"
        },
        "systemTime": {
          "$ref": "#/$defs/DateTime"
        },
        "displayTime": {
          "$ref": "#/$defs/DateTime"
        },
        "eventType": {
          "$ref": "#/$defs/EventType"
        },
        "eventSubType": {
          "type": "string",
          "nullable": true,
          "description": "For example `fastActing` or `longActing` for `insulin`, or `light` / `medium` / `heavy` for `exercise`."
        },
        "value": {
          "type": "number",
          "nullable": true
        },
        "unit": {
          "type": "string",
          "nullable": true,
          "description": "Unit appropriate to `eventType` (e.g. `grams`, `units`, `minutes`)."
        },
        "eventStatus": {
          "$ref": "#/$defs/EventStatus"
        },
        "transmitterId": {
          "type": "string",
          "nullable": true
        },
        "transmitterGeneration": {
          "$ref": "#/$defs/TransmitterGeneration"
        },
        "displayDevice": {
          "type": "string",
          "nullable": true
        }
      }
    },
    "EventStatus": {
      "type": "string",
      "enum": [
        "created",
        "updated",
        "deleted"
      ]
    },
    "EventType": {
      "type": "string",
      "enum": [
        "unknown",
        "carbs",
        "insulin",
        "exercise",
        "health",
        "bloodGlucose",
        "notes"
      ]
    },
    "DateTime": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 timestamp."
    },
    "TransmitterGeneration": {
      "type": "string",
      "enum": [
        "unknown",
        "g4",
        "g5",
        "g6",
        "g6+",
        "dexcomPro",
        "g7"
      ]
    }
  }
}