Gets the latest subscriber info or creates one if it doesn't exist.
Get OR create a subscriber
If the provided
app_user_id
doesn't exists, a new subscriber will be created with the App User Id.
Response
If the provided app_user_id
exists, the response will contain the latest purchase information for that user.
Attribute | Description |
---|---|
| The ISO 8601 datetime of the request. |
| The Unix timestamp of the request. |
|
The Subscriber object:
Attribute | Description |
---|---|
| The first app user ID that was registered for this user. |
| Only available on iOS. This will be |
| Only available on iOS. The date that the app was first purchased/downloaded by the user. Will be |
| URL 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. 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
|
| The ISO 8601 datetime string corresponding to when this user was first seen in RevenueCat . |
| The ISO 8601 datetime string corresponding to when this user was last seen in RevenueCat. |
| A mapping of Entitlement objects keyed by entitlement ID. |
| A mapping of Subscription objects keyed by product ID. |
| A mapping of Non-Subscription object arrays keyed by product ID. Non-Subscription Purchases include consumables, non-consumables, and non-renewing subscriptions. |
| Deprecated. See |
| A dictionary of subscriber attribute keys to Subscriber Attribute objects. Only included in requests made with secret keys. For more details on subscriber attributes, see our Subscriber Attributes guide. |
The Entitlement object:
Attribute | Description |
---|---|
| The ISO 8601 datetime this entitlement is set to expire (may be in the past). |
| The ISO 8601 datetime when the grace period for the subscription would expire. Will be null if user if not in a grace period. |
| The ISO 8601 datetime of the latest purchase or renewal. |
| The product identifier that unlocked this entitlement. |
The Subscription object:
Attribute | Description |
---|---|
| The ISO 8601 datetime of the latest known expiration date. |
| The ISO 8601 datetime of the latest purchase or renewal. |
| The ISO 8601 datetime of the first recorded purchase of this product. |
| Possible values:
|
| Possible values for
|
| Possible values for
|
| Boolean indicating whether the subscription was purchased in sandbox or production environment. |
| The ISO 8601 datetime that an unsubscribe was detected. Will be null if previously unsubscribed user has resubscribed. Note the subscription may still be active, check the |
| The ISO 8601 datetime that billing issues were detected. Will be null if previous billing issues were resolved. Note the subscription may still be active, check the |
| The ISO 8601 datetime when the grace period for the subscription would expire. Will be null if user if not in a grace period. |
The Non-Subscription object:
Attribute | Description |
---|---|
| A unique identifier for the transaction. You can use this to ensure you track consumption of all consumable products. |
| The ISO 8601 datetime that the purchase happened. |
| Possible values for
|
| Boolean indicating whether the subscription was purchased in sandbox or production environment. |
The Subscriber Attribute object:
Attribute | Description | |
---|---|---|
| The string value of the attribute. | |
| The Unix timestamp of when the attribute was last updated. |
Secret API Key Required For Subscriber Attributes
The Subscriber Attribute object will only be included in requests made with a secret API key.