Individual Content Entitlements

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.

Individual content entitlements are purchases, rentals, and recordings that are not part of a subscription entitlement. Fire TV may use entitlement information to determine correct entitlements for row creation and update the detail page with the correct providers. Purchases, rentals, and DVR recordings may be added to corresponding rows in the My Stuff page.

What to send

For each trigger (see when to send), send events with the fields below. There is no need to filter the data you send or check for duplicates. Amazon does this as necessary.

Submit this information for individual content (not a subscription) entitlements.

Field Name	Required (Y/N)	Description
Content ID	Y	Corresponds to a content ID provided to Fire TV through the Amazon 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.

When to send

On initial app launch and sign-in.
On purchasing or renting new individual content.
If an individual content entitlement expires or is no longer valid.
If the expiration date or time changes.
When asked to refresh by Fire TV’s on-device service.

How to send

Use this code to send individual content entitlement data:

Copied to clipboard.

// Example content entitlement event generated when user purchases new content in the app

const entitlements: IContentEntitlement = new ContentEntitlementBuilder()
    .acquisitionTimestamp(new Date())
    .contentId(
    new ContentIdBuilder()
        .id('content_CDF_ID')
        .idNamespace(ContentIdNamespaces.NAMESPACE_CDF_ID)
        .build(),
    )
    .entitlementType(EntitlementType.PURCHASE)
    .expirationTimestamp(new Date("2025-12-17T03:24:00"))
    .build();
 
 // Send the event
 ContentPersonalizationServer.reportNewContentEntitlement(entitlements);

Last updated: Sep 30, 2025