RevenueCat makes it easy to determine subscription status and more with the _Purchases SDK_ and [REST API](πŸ”—ο»Ώ).

509
ο»Ώ

## Get User Information

The <<glossary:CustomerInfo>> object contains all of the purchase and subscription data available about the user. This object is updated whenever a purchase or restore occurs and periodically throughout the lifecycle of your app. The latest information can always be retrieved by calling `getCustomerInfo()`:

ο»Ώ

It's safe to call `getCustomerInfo()` frequently throughout your app. Since the SDK updates and caches the latest <<glossary:CustomerInfo>> when the app becomes active, the completion block won't need to make a network request in most cases.

Working with the cache

The SDK caches the user's subscription information to reduce your app's reliance on the network. Users who unlock entitlements will be able to access them even without an internet connection. The SDK will update the cache if it's older than 5 minutes, but only if you call `getCustomerInfo()`, make a purchase, or restore purchases, so it's a good idea to call `getCustomerInfo()` any time a user accesses premium content.

The `CustomerInfo` object gives you access to the following information about a user:

NameDescription
Request DateThe server date when the current <<glossary:CustomerInfo>> object was fetched. This is affected by the cache on device so you should not use it when you need the current time to calculate info such as time elapsed since purchase date. For that you should use device time.
Original App User IDThe original App User ID recorded for this user. May be the same as their current App User ID. See our [Identifying Users](πŸ”—ο»Ώ) guide for more information.
First SeenThe date this user was first seen in RevenueCat. This is the install date in most cases
Original Application VersioniOS only. The version number for the first version of the app this user downloaded. Will be `nil` unless a receipt has been recorded for the user through a purchase, restore, or import. Note in sandbox this will always be "1.0" Useful for [migrating existing apps to subscriptions](πŸ”—ο»Ώ).
Original Purchase DateiOS only. The date that the app was first purchased/downloaded by the user. Will be `nil` if no receipt is recorded for the user. Useful for [migrating existing apps to subscriptions](πŸ”—ο»Ώ).
Management URLURL to manage the active subscription of the user. If the user has an active iOS subscription, this will point to the App Store, if the user has an active Play Store subscription it will point there. For Stripe subscriptions, there is no Management URL. If there are no active subscriptions it will be null. If the user has multiple active subscriptions for different platforms, this will take the value of the OS in the X-Platform header into consideration: ο»Ώ- If the request was made on an OS for which there are active subscriptions, this will return the URL for the store that matches the header. ο»Ώ- If the request was made on a different OS or the OS was not included in the X-Platform header, this will return the URL for the store of the subscription with the farthest future expiration date.
All Purchased Product IdentifiersAn array of product identifiers purchased by the user regardless of expiration.
Non Consumable PurchasesAn array of all the non-consumable product identifiers purchased by the user.
Active SubscriptionsAn array of subscription product identifiers that are active. You should be using [entitlement](πŸ”—ο»Ώ) though.
Entitlements`EntitlementInfo` objects that contain information about the user's entitlements, such as subscription state. See more [below](πŸ”—ο»Ώ).

## Get Entitlement Information

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

NameDescription
IdentifierThe entitlement identifier configured in the RevenueCat dashboard.
Product IdentifierThe underlying product identifier that unlocked this entitlement.
Is ActiveWhether or not the user has access to this entitlement.
Will RenewWhether or not the entitlement is set to renew at the end of the current period. Note there may be a multiple hour delay between the value of this property and the actual state in the App Store / Play Store.
Period TypeThe period type this entitlement is in, can be one of: - Trial: In a free trial period - Promotional: In a promotional period - Intro: In an introductory price period - Normal: In the default period
Latest Purchase DateThe latest purchase or renewal date for this entitlement.
Original Purchase DateThe first date this entitlement was purchased. May be the same as the latest purchase date.
Expiration DateThe expiration date for the entitlement, can be null for lifetime access. If the period type is trial then this is the trial expiration date.
StoreThe store that unlocked this entitlement, can be one of: - App Store - Mac App Store - Play Store - Amazon Appstore - Stripe - Promotional (RevenueCat)
Is SandboxWhether this entitlement was unlocked from a sandbox or production purchase.
Unsubscribe Detected AtThe date an unsubscribe was detected. An unsubscribe **does not** mean that the entitlement is inactive. Note there may be a multiple hour delay between the value of this property and the actual state in the App Store / Play Store. This delay can be reduced by enabling [Platform Server Notifications](πŸ”—ο»Ώ).
Billing Issue Detected AtThe date a billing issue was detected, will be null again once billing issue resolved. A billing issue **does not** mean that the entitlement is inactive. Note there may be a multiple hour delay between the value of this property and the actual state in the App Store / Play Store. This delay can be reduced by enabling [Platform Server Notifications](πŸ”—ο»Ώ).

## Checking If A User Is Subscribed

The subscription status for a user can easily be determined with the `CustomerInfo` and `EntitlementInfo` objects.

For most apps that only have one entitlement, the `isActive` status can be quickly checked for your entitlement ID.

ο»Ώ

If your app has multiple entitlements and you need to check if a user is subscribed to at least one you can also check for the entitlement Id in the `active` dictionary of `EntitlementInfo` objects.

ο»Ώ

It's important to note that <<glossary:CustomerInfo>> will be empty if no purchases have been made and no transactions have been synced. This means that entitlements may not exist in CustomerInfo even if they have been set up in the RevenueCat dashboard.

## Listening For CustomerInfo Updates

Since _Purchases_ SDK works seamlessly on any platform, a user's <<glossary:CustomerInfo>> may change from a variety of sources. You can respond to any changes in CustomerInfo by conforming to an optional delegate method, `purchases:receivedUpdated:`. This will fire whenever we receive a _change_ in CustomerInfo _on the current device_ and you should expect it to be called at launch and throughout the life of the app.

CustomerInfo updates are not pushed to your app from the RevenueCat backend, updates can only happen from an outbound network request to RevenueCat.

Depending on your app, it may be sufficient to ignore the delegate and simply handle changes to customer information the next time your app is launched. Or throughout your app as you request new `CustomerInfo` objects.

ο»Ώ

## Web Apps

If you also have a web app, or need to get a user's subscription status from outside of the _Purchases SDK_, you should use the REST API. You can read the full API reference [here](πŸ”—ο»Ώ).

ο»Ώ

## Handling Refunds

RevenueCat can handle refunds across all platforms for both subscription and non-subscription products. As soon as RevenueCat detects a refund, the <<glossary:CustomerInfo>> will be updated to reflect the correct entitlement status - no action required on your part! If you have questions about refunds, take a look at our [community article](πŸ”—ο»Ώ) covering the topic.

Granting refunds for Google Play subscriptions

In order for RevenueCat to detect refunds for Google Play, you must grant the refund via the [RevenueCat dashboard](πŸ”—ο»Ώ) or [API](πŸ”—ο»Ώ).

Refunds granted via the Google Play Console are not properly detected as refunds in RevenueCat.

## Next Steps

  • Once you're ready to test your integration, you can follow our guides on [testing and debugging ](πŸ”—ο»Ώ)ο»Ώ