This object gives you access to all the information about the status of a user's entitlements.

interface EntitlementInfo {
    billingIssueDetectedAt: null | Date;
    expirationDate: null | Date;
    identifier: string;
    isActive: boolean;
    isSandbox: boolean;
    latestPurchaseDate: Date;
    originalPurchaseDate: Date;
    ownershipType: null | OwnershipType;
    periodType: PeriodType;
    productIdentifier: string;
    productPlanIdentifier: null | string;
    store: Store;
    unsubscribeDetectedAt: null | Date;
    willRenew: boolean;
}

Properties

billingIssueDetectedAt: null | Date

The date a billing issue was detected. Can be null if there is no billing issue or an issue has been resolved. Note: Entitlement may still be active even if there is a billing issue. Check the isActive property.

expirationDate: null | Date

The expiration date for the entitlement, can be null for lifetime access. If the EntitlementInfo.periodType is trial, this is the trial expiration date.

identifier: string

The entitlement identifier configured in the RevenueCat dashboard.

isActive: boolean

True if the user has access to the entitlement.

isSandbox: boolean

False if this entitlement is unlocked via a production purchase.

latestPurchaseDate: Date

The latest purchase or renewal date for the entitlement.

originalPurchaseDate: Date

The first date this entitlement was purchased.

ownershipType: null | OwnershipType

Use this property to determine whether a purchase was made by the current user or shared to them by a family member. This can be useful for onboarding users who have had an entitlement shared with them, but might not be entirely aware of the benefits they now have.

periodType: PeriodType

The last period type this entitlement was in.

productIdentifier: string

The product identifier that unlocked this entitlement.

productPlanIdentifier: null | string

The base plan identifier that unlocked this entitlement (For Google Play subs only).

store: Store

The store where this entitlement was unlocked from.

unsubscribeDetectedAt: null | Date

The date an unsubscribe was detected. Can be null. Note: Entitlement may still be active even if user has unsubscribed. Check the EntitlementInfo.isActive property.

willRenew: boolean

True if the underlying subscription is set to renew at the end of the billing period (expirationDate). Will always be True if entitlement is for lifetime access.