Subscriptions
Subscriptions

Sync Subscription Status

Sync subscription status with RevenueCat.

Call this on app launch to ensure local DB matches RevenueCat state. Useful if webhooks were missed or for initial sync.

When to call:

  • App launch/foreground
  • After completing a purchase in the app
  • When subscription status seems stale

Returns: Quick subscription status with updated data from RevenueCat.

post/api/v1/subscriptions/sync

Request

  • Base URL: https://api.gemstoneaiapp.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.gemstoneaiapp.com/api/v1/subscriptions/sync
  • Auth: HTTP bearer

Response

Successful Response

plan_typestring required

'free' or 'premium'

is_activeboolean required

Is subscription active?

is_premiumboolean required

True if user has active premium subscription, False otherwise

scans_limitinteger nullable

Monthly scan limit (null if unlimited)

collection_limitinteger nullable

Collection size limit (null if unlimited)

Example response

{
  "collection_limit": 10,
  "collection_slots_remaining": 7,
  "is_active": true,
  "is_premium": false,
  "plan_type": "free",
  "scans_limit": 5,
  "scans_remaining": 3
}

Changes

No recorded changes to this operation across all 1 revision of this API.