Watch activity
| Field Name | Required (Y/N) | Description |
|---|---|---|
| Content ID | Y | ID of the content the customer is watching as specified through Amazon’s catalog integration. |
| Live Channel Descriptor | Y* | Channel Descriptor of the live linear channel playing the content as specified through catalog integration. * Required for live content only. |
| Internal Profile ID | Y | Provides an obfuscated Profile ID so Fire TV can associate the activity with the correct app customer. |
| Duration | Y | Length of content in milliseconds. |
| Current Playback Position | Y | Offset from start of content in milliseconds, excluding interstitial content (previews, ads, etc.). |
| Credits Position | N | Position of the credits in the content. Offset from start of content in milliseconds, excluding interstitial content (previews, ads, etc.). This field helps Fire TV know when a customer has finished watching the content. |
| Event Timestamp | N* | * This is required for off-device events, but not for active events. |
| Playback State | Y | Enum representing the state of content playback. See the API documentation for a list of Enum values. |
Individual content entitlement
| Field Name | Required (Y/N) | Description |
|---|---|---|
| Content ID | Y | Corresponds to the content ID provided to Fire TV through Amazon’s catalog integration. |
| Type | Y | One of the following: Recording, Purchase, or Rental. This allows Fire TV to correctly label the content for the customer in the UI. |
| Expiration Date | N | Timestamp for when this content entitlement expires. Value of less than or equal to 0 implies no expiration. |
| Entitlement Acquisition Date | Y | Timestamp for when the customer purchased the content or the time an episode was recorded. Absense means the current time is used. |
Watchlist
| Field Name | Required (Y/N) | Description |
|---|---|---|
| Content ID | Y | Corresponds to the content ID provided to Fire TV through the catalog integration. |
| Date When Added | Y | Timestamp for when the customer added the entry to the watchlist |
| Internal Profile ID | Y | An obfuscated Profile ID so Fire TV can associate the activity with the correct app customer. |
Content interaction
| Field Name | Required (Y/N) | Description |
|---|---|---|
| Content ID | Y | Corresponds to the content ID provided to Fire TV through the catalog integration. |
| Interaction Date | Y | Timestamp for when the interaction occurred. |
| Internal Profile ID | Y | An obfuscated Profile ID so that Fire TV can associate the activity with the correct app customer. |
| Interaction Type | Y | Enum indicating the interaction type. See API documentation for a list of Enum values. |

