Data Type Reference
Open Beta Documentation Amazon offers this technical
documentation as part of a pre-release, open beta. The features described might change as Amazon receives feedback
and iterates on the features. For the most current feature information, see the Release
Notes.
For each trigger (see "When to send" for each data type), send the correct event with the below fields. There is no need to filter the data you send or check for duplicates. Amazon does this as necessary.
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. |
| Interaciton Type | Y | Enum indicating the interaction type. See API documentation for a list of Enum values. |
Next steps
For another handy reference for triggers and SDK calls, see our Summary Reference Table.
Last updated: Sep 30, 2025
