Category-3 Scopes

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Alexa Settings",
  "description": "Includes Device, Account and Person Settings.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "settingKey": {
        "description": "The description of the setting (e.g., Alexa.Presence.videoDetectionMode).",
        "type": "string"
      },
      "value": {
        "description": "The value of the setting (e.g., OFF).",
        "type": [
          "string",
          "boolean",
          "object",
          "number",
          "array"
        ]
      },
      "principalType": {
        "description": "The type of the setting.",
        "type": "string"
      },
      "eventDate": {
        "description": "Last updated time for the setting.",
        "type": "string"
      }
    },
    "required": [
      "settingKey",
      "value",
      "principalType",
      "eventDate"
    ],
    "unevaluatedProperties": false
  }
}

[
  {
    "settingKey": "System.locales",
    "value": "en-US",
    "principalType": "Device Setting",
    "eventDate": "1970-01-01T00:00:00Z"
  }
]

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Audio Group Settings - Audio Groups",
  "description": "Includes details about a customer's audio groups",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "clusterName": {
        "type": "string",
        "description": "Speaker group friendly name"
      },
      "groupType": {
        "type": "string",
        "description": "Type of speaker group"
      },
      "clusterMembers": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "List of device serial numbers that compose the cluster"
      },
      "audioSyncDeviceSkews": {
        "type": "object",
        "additionalProperties": {
          "type": "string"
        },
        "description": "A map of cluster member device id to corresponding bluetooth skew time data when applicable to device"
      }
    },
    "required": [
      "clusterName",
      "groupType",
      "clusterMembers"
    ],
    "unevaluatedProperties": false
  }
}

[
  {
    "clusterName": "Great Room",
    "groupType": "A3C9PE6BDELTCH",
    "clusterMembers": ["GK022H07251601SH", "GK022H07251601SS"],
    "audioSyncDeviceSkews": {
      "GK022H07251601SH": "181.102"
    }
  }
]

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Pairing Suggestions",
  "description": "Includes details about suggested device pairings",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "deviceSerialNumber": {
        "type": "string",
        "description": "Device serial number of device being registered"
      },
      "pairingSuggestionDevices": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "List of device serial numbers corresponding to devices suggested for pairing with new device registered"
      },
      "creationTime": {
        "type": "string",
        "format": "date-time",
        "description": "Timestamp corresponding to pairing suggestion record creation"
      },
      "updatedTime": {
        "type": "string",
        "format": "date-time",
        "description": "Timestamp corresponding to most recent update for pairing suggestion record"
      },
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the pairing suggestion was created or updated"
      }
    },
    "required": [
      "deviceSerialNumber",
      "pairingSuggestionDevices",
      "creationTime",
      "updatedTime",
      "eventDate"
    ],
    "unevaluatedProperties": false
  }
}

[
  {
    "deviceSerialNumber": "GK022H07251601SH",
    "pairingSuggestionDevices": ["GK022H07251601SH", "GK022H07251601SS"],
    "creationTime": "2024-08-10T22:51:54Z",
    "updatedTime": "2024-08-10T22:51:54Z",
    "eventDate": "2024-08-10T22:51:54Z"
  }
]

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Reminders",
  "description": "Includes details about reminders, tasks, and notifications created by customers",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "deviceName": {
        "type": "string",
        "description": "Name of device provided by customer."
      },
      "createdDate": {
        "type": "string",
        "format": "date-time",
        "description": "Created date of the DB entry."
      },
      "type": {
        "type": "string",
        "description": "Type of notification."
      },
      "timezone": {
        "type": "string",
        "description": "Timezone."
      },
      "scheduledDateAndTime": {
        "type": "string",
        "description": "Trigger date and time of reminder."
      },
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "Last updated date."
      },
      "stoppedTime": {
        "type": "string",
        "format": "date-time",
        "description": "Stopped time."
      },
      "skillName": {
        "type": "string",
        "description": "Name of the skill that created the reminder."
      },
      "label": {
        "type": "string",
        "description": "Label of the task."
      },
      "status": {
        "type": "string",
        "enum": [
          "OFF",
          "ON",
          "SNOOZED",
          "PAUSED",
          "Incomplete",
          "Complete"
        ],
        "description": "Status of the reminder or task."
      },
      "personalizationType": {
        "type": "string",
        "enum": [
          "Personal",
          "Assigned"
        ],
        "description": "Whether the reminder was personal or assigned."
      },
      "assigner": {
        "type": "string",
        "description": "Name of the person in the household who assigned the task."
      },
      "assignee": {
        "type": "string",
        "description": "Name of the person in the household who the task is assigned to."
      },
      "reminderDurationInMilliseconds": {
        "type": "string",
        "description": "Duration of time in milliseconds until a reminder should trigger."
      },
      "reminderDeferredTime": {
        "type": "string",
        "format": "date-time",
        "description": "Time at which a reminder was deferred."
      },
      "scheduledTime": {
        "type": "string",
        "description": "Reminder's trigger time."
      },
      "recurrenceStartDate": {
        "type": "string",
        "format": "date-time",
        "description": "Date of when recurring reminder should start."
      },
      "recurrenceStartTime": {
        "type": "string",
        "description": "Time of when recurring reminder should start."
      },
      "recurrenceEndDate": {
        "type": "string",
        "format": "date-time",
        "description": "Date of when recurring reminder should end."
      },
      "recurrenceEndTime": {
        "type": "string",
        "description": "Time of when recurring reminder should end."
      },
      "recurrence": {
        "type": "string",
        "description": "Recurrence rules associated with a reminder."
      },
      "followUpReminder": {
        "type": "string",
        "enum": [
          "Yes",
          "No"
        ],
        "description": "Flag if the reminder set is a follow up and requires completion to stop ringing."
      },
      "pushNotifications": {
        "type": "string",
        "enum": [
          "Enabled",
          "Disabled"
        ],
        "description": "Flag if customer has push notifications enabled on reminder delivery."
      },
      "deliveryMode": {
        "type": "string",
        "enum": [
          "All devices",
          "Spoken device",
          "Nearby devices",
          "Device group"
        ],
        "description": "Mode in how reminders are delivered."
      },
      "reminderAnnouncementRepetitions": {
        "type": "string",
        "enum": [
          "1",
          "2",
          "3",
          "Persistent"
        ],
        "description": "Number of times a reminder is announced upon delivery."
      },
      "disableDefaultReminderAnnouncementRepetitions": {
        "type": "string",
        "enum": [
          "Yes",
          "No"
        ],
        "description": "Flag if customer overrode the default number of times a reminder is announced upon delivery."
      },
      "taskNote": {
        "type": "string",
        "description": "Note associated with the task."
      },
      "suggestedActionStatus": {
        "type": "string",
        "description": "Status of the Alexa-suggested action."
      }
    },
    "required": [
      "createdDate",
      "type",
      "eventDate",
      "label"
    ],
    "unevaluatedProperties": false
  }
}

[
  {
    "deviceName": "Nick's Echo Show",
    "createdDate": "2022-07-05T00:56:00.000Z",
    "type": "Reminder",
    "timezone": "America/Los_Angeles",
    "scheduledDateAndTime": "2022-04-27T01:30:00.000Z",
    "eventDate": "2022-04-27T01:30:00.000Z",
    "stoppedTime": "2022-04-27T01:30:00.000Z",
    "skillName": "Alexa Smart Home",
    "label": "Walk the dog",
    "status": "ON",
    "personalizationType": "Personal",
    "assigner": "John Smith",
    "assignee": "Jane Smith",
    "reminderDurationInMilliseconds": "0",
    "reminderDeferredTime": "2019-10-09T02:48:36.515Z",
    "scheduledTime": "15:30",
    "recurrenceStartDate": "2022-04-27T01:30:00.000Z",
    "recurrenceStartTime": "01:30",
    "recurrenceEndDate": "2022-04-27T01:30:00.000Z",
    "recurrenceEndTime": "01:30",
    "recurrence": "Every Monday",
    "followUpReminder": "Yes",
    "pushNotifications": "Enabled",
    "deliveryMode": "All devices",
    "reminderAnnouncementRepetitions": "1",
    "disableDefaultReminderAnnouncementRepetitions": "No",
    "taskNote": "Fix the computer",
    "suggestedActionStatus": "Pending"
  }
]

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Device Pairing",
  "description": "Device pairing information for Alexa Video devices.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The ISO 8601 formatted timestamp of when this pairing association was updated. Not indicative of when pairing was initially created but last updated."
      },
      "status": {
        "type": "string",
        "description": "Whether or not this pairing association should be ignored."
      },
      "type": {
        "type": "string",
        "description": "Whether or not is NestedTargetDevice. This field indicating indirect device associations through a host device when there's no direct link between the source and target devices."
      },
      "isWelcomeMessagePlayed": {
        "type": "boolean",
        "description": "Whether or not this device association should render a welcome message when the app is targeted."
      },
      "sourceDeviceSerialNumber": {
        "type": "string",
        "description": "Source device's Amazon device serial number."
      },
      "sourceDeviceType": {
        "type": "string",
        "description": "A friendly name of source device's device type."
      },
      "targetDeviceSerialNumber": {
        "type": "string",
        "description": "Target device's Amazon device serial number."
      },
      "deviceRefreshTime": {
        "oneOf": [
          {
            "type": "string",
            "format": "date-time"
          },
          {
            "type": "string",
            "const": "Not Available"
          }
        ],
        "description": "The ISO 8601 formatted timestamp of when target device will become inactive."
      },
      "deviceLastAccessedTime": {
        "oneOf": [
          {
            "type": "string",
            "format": "date-time"
          },
          {
            "type": "string",
            "const": "Not Available"
          }
        ],
        "description": "The ISO 8601 formatted timestamp of the directive sent to the target device."
      },
      "targetAppName": {
        "type": "string",
        "description": "Name of the target application, eg, Prime Video, Hulu. If it does not exist, this field would be Not Available."
      }
    },
    "required": [
      "eventDate",
      "status",
      "type",
      "isWelcomeMessagePlayed",
      "sourceDeviceSerialNumber",
      "sourceDeviceType",
      "targetDeviceSerialNumber",
      "deviceRefreshTime",
      "deviceLastAccessedTime",
      "targetAppName"
    ],
    "unevaluatedProperties": false
  }
}

[
  {
    "eventDate": "2024-05-13T17:12:25.399Z",
    "status": "Enabled",
    "type": "Application",
    "isWelcomeMessagePlayed": true,
    "sourceDeviceSerialNumber": "GXX0VC3R8A9R734L",
    "sourceDeviceType": "Echo Show",
    "targetDeviceSerialNumber": "GXX15X3SH7V5V14S",
    "deviceRefreshTime": "1970-01-01T00:00:00.000Z",
    "deviceLastAccessedTime": "1970-01-01T00:00:00.000Z",
    "targetAppName": "Prime Video"
  }
]

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "WhisperNoticeState",
  "description": "Persists information about whether the customer has been notified, per device, about the whisper feature prior to their first whisper interaction.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "deviceSerialNumber": {
        "description": "Device serial number",
        "type": "string"
      },
      "whisperInvitationDate": {
        "description": "The date at which the whisper invitation was sent for the given device.",
        "type": "string",
        "format": "date-time"
      },
      "whisperNotificationDate": {
        "description": "The date at which the whisper notification was sent for the given device. The whisper notification informs the customer that the device will whisper.",
        "type": "string",
        "format": "date-time"
      },
      "eventDate": {
        "description": "The date when the entry was last updated.",
        "type": "string",
        "format": "date-time"
      }
    },
    "required": [
      "deviceSerialNumber",
      "eventDate"
    ],
    "unevaluatedProperties": false
  }
}

[
  {
    "deviceSerialNumber": "G123MW45678901A2",
    "whisperInvitationDate": "2024-03-29T19:20:21.777Z",
    "whisperNotificationDate": "2024-03-29T19:20:21.777Z",
    "eventDate": "2024-04-16T19:20:21.999Z"
  }
]

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "WhisperAppliedDeviceEffects",
  "description": "Persists information about the customer's device volume in order to support the whisper feature.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "deviceSerialNumber": {
        "description": "Device serial number",
        "type": "string"
      },
      "actualVolume": {
        "description": "Original customer device volume before modifying it for whisper.",
        "type": "integer"
      },
      "whisperVolume": {
        "description": "Indicates whether the device volume was modified for whisper.",
        "type": "string",
        "enum": [
          "ON",
          "OFF"
        ]
      },
      "eventDate": {
        "description": "The date when the entry was created.",
        "type": "string",
        "format": "date-time"
      }
    },
    "required": [
      "deviceSerialNumber",
      "eventDate"
    ],
    "unevaluatedProperties": false
  }
}

[
  {
    "deviceSerialNumber": "G123MW45678901A2",
    "actualVolume": 50,
    "whisperVolume": "ON",
    "eventDate": "2024-04-16T19:20:21.999Z"
  }
]

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Device Engagement",
  "description": "Device usage data including device information and software details.",
  "type": "array",
  "items": {
    "type": "object",
    "required": [
      "eventDate",
      "deviceSerialNumber",
      "deviceType"
    ],
    "unevaluatedProperties": false,
    "properties": {
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "Time when a metric is recorded on a device."
      },
      "deviceSerialNumber": {
        "type": "string",
        "description": "Device Serial Number."
      },
      "deviceType": {
        "type": "string",
        "enum": [
          "FIRETV",
          "FIRE TABLETS",
          "ECHO",
          "KINDLE"
        ],
        "description": "Device type."
      },
      "countryOfResidence": {
        "type": "string",
        "description": "Country of residence of registered customer using device"
      },
      "softwareVersion": {
        "type": "string",
        "description": "Device software version"
      },
      "productMode": {
        "type": "string",
        "description": "Attribute which specified if device is used in Show mode or Default mode."
      },
      "metricLevel": {
        "type": "string",
        "description": "Attribute representing the type of metric being measured."
      },
      "reasonCode": {
        "type": "string",
        "description": "What triggered the metric."
      }
    }
  }
}

[
  {
    "eventDate": "2017-05-06 22:06:04.0",
    "deviceSerialNumber": "0094052161860CT8",
    "deviceType": "ECHO",
    "countryOfResidence": "US",
    "softwareVersion": "54.5.7.3_user_573210520",
    "productMode": "SHOW_MODE",
    "metricLevel": "appAction",
    "reasonCode": "VOICE_OFF"
  }
]

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "App Engagement",
  "description": "Application usage data including device information and app metrics.",
  "type": "array",
  "items": {
    "type": "object",
    "required": [
      "eventDate",
      "deviceSerialNumber",
      "deviceType"
    ],
    "unevaluatedProperties": false,
    "properties": {
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "Time when a metric is recorded on device."
      },
      "deviceSerialNumber": {
        "type": "string",
        "description": "Device Serial Number."
      },
      "countryOfResidence": {
        "type": "string",
        "description": "Country of residence of registered customer using device."
      },
      "appPackageName": {
        "type": "string",
        "description": "Package name of application for which metric is associated."
      },
      "appVersionName": {
        "type": "string",
        "description": "Version of the application for which the metric is associated."
      },
      "appVersionCode": {
        "type": "string",
        "description": "Numeric value of the application version."
      },
      "deviceType": {
        "type": "string",
        "enum": [
          "FIRETV",
          "FIRE TABLETS",
          "ECHO",
          "KINDLE"
        ],
        "description": "Device Type"
      },
      "deviceProfileType": {
        "type": "string",
        "enum": [
          "Adult",
          "Teen"
        ],
        "description": "Profile Type."
      },
      "appProfileType": {
        "type": "string",
        "enum": [
          "Adult",
          "Teen"
        ],
        "description": "Type of App profile."
      },
      "launchCount": {
        "type": "string",
        "description": "Number of times app has been launched."
      },
      "durationMilliseconds": {
        "type": "string",
        "description": "Duration of app in use for the metric session in milliseconds."
      },
      "softwareVersion": {
        "type": "string",
        "description": "Device software version."
      },
      "metricLevel": {
        "type": "string",
        "description": "Attribute representing the type of metric being measured."
      },
      "productMode": {
        "type": "string",
        "description": "Attribute which specified if device is used in Show mode or Default mode."
      },
      "reasonCode": {
        "type": "string",
        "description": "Describes context of metric."
      },
      "metricSource": {
        "type": "string",
        "description": "Device source of metric."
      },
      "startTime": {
        "type": "string",
        "format": "date-time",
        "description": "Timestamp when the app launched."
      }
    }
  }
}

[
  {
    "eventDate": "2017-05-06 22:06:04.0",
    "deviceSerialNumber": "0094052161860CT8",
    "countryOfResidence": "US",
    "appPackageName": "com.amazon.avod",
    "appVersionName": "5.7.3-17",
    "appVersionCode": "573001710",
    "deviceType": "ECHO",
    "deviceProfileType": "Adult",
    "appProfileType": "Adult",
    "launchCount": "7",
    "durationMilliseconds": "901141",
    "softwareVersion": "36.5.7.3_user_573210520",
    "metricLevel": "appAction",
    "productMode": "SHOW_MODE",
    "reasonCode": "VOICE_OFF",
    "metricSource": "APP",
    "startTime": "2017-05-06 22:06:04.0"
  }
]

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Device Engagement 3p ACK",
  "description": "Third-party device usage data including device information and software details.",
  "type": "array",
  "items": {
    "type": "object",
    "required": [
      "eventDate",
      "deviceSerialNumber",
      "deviceType"
    ],
    "unevaluatedProperties": false,
    "properties": {
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "Time when a metric is recorded on device."
      },
      "deviceSerialNumber": {
        "type": "string",
        "description": "Device serial number."
      },
      "deviceType": {
        "type": "string",
        "enum": [
          "FIRETV",
          "FIRE TABLETS",
          "ECHO",
          "KINDLE"
        ],
        "description": "Device type."
      },
      "countryOfResidence": {
        "type": "string",
        "description": "Country of residence of registered customer using device."
      },
      "softwareVersion": {
        "type": "string",
        "description": "Device software version."
      },
      "productMode": {
        "type": "string",
        "description": "Attribute which specified if device is used in Show mode or Default mode."
      },
      "metricLevel": {
        "type": "string",
        "description": "Attribute representing the type of metric being measured."
      },
      "reasonCode": {
        "type": "string",
        "description": "Describes context of metric."
      }
    }
  }
}

[
  {
    "eventDate": "2017-05-06 22:06:04.0",
    "deviceSerialNumber": "0094052161860CT8",
    "deviceType": "ECHO",
    "countryOfResidence": "US",
    "softwareVersion": "54.5.7.3_user_573210520",
    "productMode": "SHOW_MODE",
    "metricLevel": "appAction",
    "reasonCode": "VOICE_ON"
  }
]

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Device Engagement Metrics",
  "description": "Out Of Box Experience (OOBE) staging data including device and navigation details",
  "type": "array",
  "items": {
    "type": "object",
    "required": [
      "eventDate",
      "deviceSerialNumber",
      "deviceType",
      "metricName",
      "currentPage",
      "sequenceId",
      "osVersion",
      "appSessionId"
    ],
    "unevaluatedProperties": false,
    "properties": {
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "Device UTC timestamp at the time of recording the event."
      },
      "deviceSerialNumber": {
        "type": "string",
        "description": "Device Serial Number."
      },
      "deviceType": {
        "type": "string",
        "enum": [
          "FIRETV",
          "FIRE TABLETS",
          "ECHO",
          "KINDLE"
        ],
        "description": "Describes major device category."
      },
      "osVersion": {
        "type": "string",
        "description": "Device Software Version."
      },
      "deviceSessionId": {
        "type": "string",
        "description": "Device-level session (this is usually defined at the OS-layer (e.g., FOS/ACS)."
      },
      "appSessionId": {
        "type": "string",
        "description": "App-level session ID, a unique 'session' within the app itself."
      },
      "appSequenceId": {
        "type": "string",
        "description": "App-level sequence within a particular app-level session (this metric will increase the sequence ID counter by 1)."
      },
      "appPackageName": {
        "type": "string",
        "description": "The app package name that corresponds to the OOBE step."
      },
      "appVersion": {
        "type": "string",
        "description": "App version or application used for Out Of Box Experience."
      },
      "appProfileType": {
        "type": "string",
        "description": "Type of App profile."
      },
      "deviceProfile": {
        "type": "string",
        "description": "Device profile identifier."
      },
      "deviceProfileType": {
        "type": "string",
        "description": "Profile Type."
      },
      "fromPage": {
        "type": "string",
        "description": "The previous page_id."
      },
      "toPage": {
        "type": "string",
        "description": "The next page_id after the current step."
      },
      "currentPage": {
        "type": "string",
        "description": "Page Name/ID to identify the page."
      },
      "metricName": {
        "type": "string",
        "description": "The metric event."
      },
      "sequenceId": {
        "type": "string",
        "description": "High level incrementing sequence id for out of box experience process."
      },
      "eventDurationMilliseconds": {
        "type": "string",
        "description": "The duration of the event."
      }
    }
  }
}

[
  {
    "eventDate": "2021-01-08 04:25:53.0",
    "deviceSerialNumber": "G001DE4567890D6C",
    "deviceType": "ECHO",
    "osVersion": "36.5.7.3_user_573210520",
    "deviceSessionId": "b7c498dc-c394-4d93-81ed-bbd9d5d4511d",
    "appSessionId": "db5801e6-20f1-42b4-ac51-e3b1c4597da3",
    "appSequenceId": "0",
    "appPackageName": "com.amazon.oobe",
    "appVersion": "1.0.207001.0_13065210",
    "appProfileType": "Adult",
    "deviceProfile": "com.amazon.oid.AZADASASASAS",
    "deviceProfileType": "Adult",
    "fromPage": "OOBE",
    "toPage": "WiFi",
    "currentPage": "LanguagePicker",
    "metricName": "LanguagePickerModule_END",
    "sequenceId": "1",
    "eventDurationMilliseconds": "90114"
  }
]

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Total Usage",
  "description": "Total usage data including device information and usage metrics.",
  "type": "array",
  "items": {
    "type": "object",
    "required": [
      "eventDate",
      "deviceSerialNumber",
      "durationMilliseconds",
      "metricName",
      "softwareVersion"
    ],
    "unevaluatedProperties": false,
    "properties": {
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "Time when a metric is recorded on device."
      },
      "deviceSerialNumber": {
        "type": "string",
        "description": "Device serial number."
      },
      "countryOfResidence": {
        "type": "string",
        "description": "Country of residence of registered customer using device."
      },
      "startTime": {
        "type": "string",
        "format": "date-time",
        "description": "When the total usage event was started in timestamp format."
      },
      "endTime": {
        "type": "string",
        "format": "date-time",
        "description": "When the total usage event was ended in timestamp format."
      },
      "durationMilliseconds": {
        "type": "string",
        "description": "Duration of total_usage event in milliseconds."
      },
      "metricName": {
        "type": "string",
        "description": "Device metric information."
      },
      "softwareVersion": {
        "type": "string",
        "description": "Device software version."
      },
      "triggerType": {
        "type": "string",
        "description": "Describes context of total usage Metric, what triggered the metric."
      }
    }
  }
}

[
  {
    "eventDate": "2017-05-06 22:06:04.0",
    "deviceSerialNumber": "0094052161860CT8",
    "countryOfResidence": "US",
    "startTime": "2017-05-06 22:06:04.0",
    "endTime": "2017-05-06 22:06:04.0",
    "durationMilliseconds": "901141",
    "metricName": "TOTAL_USAGE",
    "softwareVersion": "36.5.7.3_user_573210520",
    "triggerType": "SCREEN_OFF"
  }
]

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Total Usage Per Day",
  "description": "This table stores total usage rolled up to a per-user/per-device, per-day level.",
  "type": "array",
  "items": {
    "type": "object",
    "required": [
      "eventDate",
      "deviceSerialNumber",
      "deviceType",
      "softwareVersion",
      "durationMilliseconds"
    ],
    "unevaluatedProperties": false,
    "properties": {
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date that has been aggregated to for this set of metrics."
      },
      "deviceSerialNumber": {
        "type": "string",
        "description": "Device serial number."
      },
      "deviceType": {
        "type": "string",
        "enum": [
          "FIRETV",
          "FIRE TABLETS",
          "ECHO",
          "KINDLE"
        ],
        "description": "Product category."
      },
      "asin": {
        "type": "string",
        "description": "ASIN of the product."
      },
      "softwareVersion": {
        "type": "string",
        "description": "Device software version."
      },
      "durationMilliseconds": {
        "type": "string",
        "description": "Total amount of time for a specific metric on the day for the specific device serial number."
      },
      "powerLossCount": {
        "type": "string",
        "description": "The number of times a customer powered off the device for the day."
      }
    }
  }
}

[
  {
    "eventDate": "2025-08-10T00:00:00Z",
    "deviceSerialNumber": "0094052161860CT8",
    "deviceType": "ECHO",
    "asin": "B00KQO3EVM",
    "softwareVersion": "36.5.7.3_user_573210520",
    "durationMilliseconds": "901141",
    "powerLossCount": "1"
 }
]

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Alexa Device Cluster",
  "description": "Device cluster predictions for alexa endpoints in customer household",
  "type": "object",
  "properties": {
    "deviceMap": {
      "type": "array",
      "description": "Map of devices in customer household to device cluster prediction",
      "items": {
        "type": "object",
        "properties": {
          "deviceSerialNumber": {
            "type": "string",
            "description": "Device serial number"
          },
          "deviceType": {
            "type": "string",
            "description": "Device type friendly name"
          },
          "deviceCluster": {
            "type": "string",
            "description": "Device cluster prediction - Each cluster is a group of devices that frequently activate together and are predicted to be in close physical proximity."
          },
          "deviceClusterConfidence": {
            "type": "string",
            "enum": [
              "High Confidence",
              "Medium Confidence",
              "Low Confidence"
            ],
            "description": "Confidence of the device cluster prediction"
          }
        },
        "required": [
          "deviceSerialNumber",
          "deviceType",
          "deviceCluster",
          "deviceClusterConfidence"
        ],
        "unevaluatedProperties": false
      }
    }
  },
  "required": [
    "deviceMap"
  ],
  "unevaluatedProperties": false
}

[
  {
    "deviceMap": [
      {
        "deviceSerialNumber": "GXX0MWR9WK0L50PA",
        "deviceType": "Echo Dot (5th gen)",
        "deviceCluster": "1",
        "deviceClusterConfidence": "High Confidence"
      }
    ]
  }
]

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Camera events data",
  "description": "Includes details about camera events of a customer like eventId, event type, image and metadata for camera recordings like event start time, end time.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "detectionType": {
        "description": "The type of event that was detected (e.g., person).",
        "type": "string"
      },
      "eventDate": {
        "description": "Timestamp when the event is detected",
        "type": "string",
        "format": "date-time"
      },
      "deviceName": {
        "description": "Name of the device that detected the event.",
        "type": "string"
      },
      "additionalDeviceNames": {
        "description": "Any additional friendly names associated with the device that detected the event.",
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "associatedImageFile": {
        "description": "Image associated with the detection event.",
        "type": "string"
      },
      "recordingStartTime": {
        "description": "Timestamp when recording started.",
        "type": "string",
        "format": "date-time"
      },
      "recordingEndTime": {
        "description": "Timestamp when recording ended.",
        "type": "string",
        "format": "date-time"
      },
      "manufacturerName": {
        "description": "Name of camera manufacturer",
        "type": "string"
      }
    },
    "required": [
      "eventDate",
      "detectionType",
      "deviceName",
      "manufacturerName"
    ],
    "unevaluatedProperties": false
  }
}

[
  {
    "detectionType": "person",
    "eventDate": "3021-12-03T16:20:50.52Z",
    "deviceName": "Front Door Camera",
    "additionalDeviceNames": ["Backyard"],
    "associatedImageFile": "abcdefg.jpg",
    "recordingStartTime": "2024-05-02T16:20:00.50Z",
    "recordingEndTime": "2024-05-02T16:20:00.50Z",
    "manufacturerName": "Ring"
  }
]

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Geolocation",
  "description": "Includes the device address of a customer.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "deviceSerialNumber": {
        "type": "string",
        "description": "The device info of the source device."
      },
      "sourceOfLocation": {
        "type": "string",
        "description": "The source of the location."
      },
      "latitudeInDegrees": {
        "type": "string",
        "description": "The latitude of the device."
      },
      "longitudeInDegrees": {
        "type": "string",
        "description": "The longitude of the device."
      },
      "coordinatesAccuracyInMeters": {
        "type": "string",
        "description": "The coordinate accuracy info of the device."
      },
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the event was generated."
      }
    }
  },
  "required": [
    "deviceSerialNumber",
    "sourceOfLocation",
    "latitudeInDegrees",
    "longitudeInDegrees",
    "coordinatesAccuracyInMeters",
    "eventDate"
  ],
  "unevaluatedProperties": false
}

[
  {
    "deviceSerialNumber": "GN434J0233540LTL",
    "sourceOfLocation": "WI-FI",
    "latitudeInDegrees": "-122.3537",
    "longitudeInDegrees": "-122.3537",
    "coordinatesAccuracyInMeters": "300",
    "eventDate": "2017-05-06 22:06:04.0"
  }
]

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Device Last Known Location",
  "description": "Includes the Geolocation info of device last known location",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "sourceDeviceSerialNumber": {
        "type": "string",
        "description": "The device info of the source device."
      },
      "accessoryDeviceSerialNumber": {
        "type": "string",
        "description": "The accessory linked with source device for location tracking."
      },
      "accessoryLatitudeInDegrees": {
        "type": "string",
        "description": "The latitude of the accessory device."
      },
      "accessoryLongitudeInDegrees": {
        "type": "string",
        "description": "The altitude of the accessory device."
      },
      "accessoryCoordinateAccuracyInMeters": {
        "type": "string",
        "description": "The coordinate accuracy info of the accessory device."
      },
      "accessoryAltitudeInMeters": {
        "type": "string",
        "description": "The altitude of the accessory device."
      },
      "accessoryAltitudeAccuracyInMeters": {
        "type": "string",
        "description": "The altitude accuracy of the accessory device."
      },
      "accessorySpeedInMetersPerSecond": {
        "type": "string",
        "description": "The device speed of the accessory device."
      },
      "accessorySpeedAccuracyInMetersPerSecond": {
        "type": "string",
        "description": "The device speed accuracy of the accessory device."
      },
      "accessoryDirectionInDegrees": {
        "type": "string",
        "description": "The heading info in degrees of the accessory device."
      },
      "accessoryDirectionAccuracyInDegrees": {
        "type": "string",
        "description": "The heading info in degrees of the accessory device."
      },
      "nearbyDeviceNames": {
        "type": "string",
        "description": "The nearby Device names."
      },
      "proximity": {
        "type": "string",
        "description": "The estimated proximity info of neighbors."
      },
      "address": {
        "type": "string",
        "description": "The Address of the device."
      },
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the event was generated."
      }
    }
  },
  "required": [
    "sourceDeviceSerialNumber",
    "accessoryDeviceSerialNumber",
    "accessoryLatitudeInDegrees",
    "accessoryLongitudeInDegrees",
    "accessoryCoordinateAccuracyInMeters",
    "accessoryAltitudeInMeters",
    "accessoryAltitudeAccuracyInMeters",
    "accessorySpeedInMetersPerSecond",
    "accessorySpeedAccuracyInMetersPerSecond",
    "accessoryDirectionInDegrees",
    "accessoryDirectionAccuracyInDegrees",
    "nearbyDeviceNames",
    "proximity",
    "address",
    "eventDate"
  ],
  "unevaluatedProperties": false
}

[
  {
    "sourceDeviceSerialNumber": "GXX0SWETD131FUF2",
    "accessoryDeviceSerialNumber": "G0G0UP089385008B",
    "accessoryLatitudeInDegrees": "47.61837",
    "accessoryLongitudeInDegrees": "-122.3537",
    "accessoryCoordinateAccuracyInMeters": "0",
    "accessoryAltitudeInMeters": "4.7",
    "accessoryAltitudeAccuracyInMeters": "0",
    "accessorySpeedInMetersPerSecond": "0",
    "accessorySpeedAccuracyInMetersPerSecond": "0",
    "accessoryDirectionInDegrees": "0",
    "accessoryDirectionAccuracyInDegrees": "0",
    "nearbyDeviceNames": "Echo Show",
    "proximity": "0",
    "address": "905 11th Ave",
    "eventDate": "2022-03-08T12:51:20Z"
  }
]

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Device Registration",
  "description": "Device registration information of Echo devices.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "deviceSerialNumber": {
        "type": "string",
        "description": "Unique serial number identifier for the Echo device."
      },
      "customerType": {
        "type": "string",
        "enum": [
          "ADULT",
          "CHILD"
        ],
        "description": "Type of customer account - either adult or child account."
      },
      "deviceAccountRole": {
        "type": "string",
        "enum": [
          "PRIMARY",
          "SECONDARY"
        ],
        "description": "Role of the device in the account - primary or secondary device."
      },
      "accountName": {
        "type": "string",
        "description": "Display name of the account associated with the device."
      },
      "firstTimeRegistered": {
        "type": "string",
        "format": "date-time",
        "description": "Timestamp when the device was first registered to an account."
      },
      "lastTimeRegistered": {
        "type": "string",
        "format": "date-time",
        "description": "Timestamp of the most recent registration event for the device."
      },
      "timeDeregistered": {
        "oneOf": [
          {
            "type": "string",
            "format": "date-time"
          },
          {
            "type": "string",
            "const": "Not Available"
          }
        ],
        "description": "Timestamp when the device was deregistered from the account, or 'Not Available' if still registered."
      },
      "state": {
        "type": "string",
        "enum": [
          "ACTIVE",
          "INACTIVE"
        ],
        "description": "Current operational state of the device registration."
      },
      "currentFirmwareVersion": {
        "type": "string",
        "description": "Version number of the firmware currently installed on the device."
      },
      "deviceModel": {
        "type": "string",
        "description": "Model identifier of the Echo device."
      },
      "localTimeOffset": {
        "type": "string",
        "description": "Time zone offset from UTC for the device's local time."
      },
      "ipAddress": {
        "type": "string",
        "description": "Last known IP address of the device."
      },
      "customerLoginPool": {
        "type": "string",
        "description": "Authentication pool used for customer login (e.g., Amazon, Enterprise)."
      },
      "devicePairingDetails": {
        "type": "array",
        "description": "List of device pairing configurations and their status.",
        "items": {
          "type": "object",
          "properties": {
            "protocol": {
              "type": "string",
              "description": "Communication protocol used for device pairing."
            },
            "status": {
              "type": "string",
              "enum": [
                "ACTIVE",
                "INACTIVE"
              ],
              "description": "Current status of the pairing connection."
            },
            "autoPairEnabled": {
              "type": "boolean",
              "description": "Whether automatic pairing is enabled for this protocol."
            }
          },
          "required": [
            "protocol",
            "status",
            "autoPairEnabled"
          ],
          "unevaluatedProperties": false
        }
      }
    },
    "required": [
      "deviceSerialNumber",
      "customerType",
      "deviceAccountRole",
      "accountName",
      "firstTimeRegistered",
      "lastTimeRegistered",
      "timeDeregistered",
      "state",
      "currentFirmwareVersion",
      "deviceModel",
      "localTimeOffset",
      "ipAddress",
      "customerLoginPool"
    ],
    "unevaluatedProperties": false
  }
}