Introduction to Vega Subscription 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.
Important: This API is not yet supported on the Vega Simulator. To test your implementation, please use the Fire TV Stick.
Vega Subscription Entitlement APIs enable sharing of specific subscription IDs associated with sets of content the customer is entitled to. This document provides an overview of the Subscription Entitlement APIs and explains the data requirements for the Vega Subscription Entitlement feature.
- To begin the step-by-step integration, see Get Started with Vega Subscription Entitlement.
- For API details, see the Subscription Entitlement Interface.
Note: We only provide an integration point on the device, so if your app doesn’t have access to the required data, work with your backend team to get the data your app needs.
What To send
For each trigger (see when to send), send event(s) with the fields below. There is no need to filter the data you send or check for duplicates. Amazon does this as necessary.
| Field Name | Required (Y/N) | Description |
|---|---|---|
| Subscription ID | Y | Subscription ID as specified in the Catalog. |
| Expiration Date | N | Timestamp for when this subscription entitlement expires. Absence implies no expiry. |
| Acquisition Date | N | Timestamp for when the customer acquired the subscription |
When To send
- On initial app launch and sign-in.
- When the customer’s subscription changes.
- When asked to refresh by Fire TV’s on-device service.
Next steps
Now that you've been introduced to the features, see Get Started with Vega Subscription Entitlement.
Last updated: Sep 30, 2025
