RevenueCat

RevenueCat

RevenueCat organizes subscription data by Project. Projects contain Apps, Offerings (product sets), and Customers. Entitlements define what a customer can access.

Data Model

• Projects — top-level container; all entities are project-scoped.
• Apps — iOS/Android apps in a project.
• Offerings — product groupings (e.g., "Premium"); contain Packages.
• Packages — individual purchasable units (monthly, annual, etc.).
• Products — App Store / Play Store product IDs.
• Customers — end users; have entitlements, purchases, subscriptions.
• Entitlements — access rights (e.g., "pro"); link to products.
• Metrics — revenue, active subscribers, churn by project.

Gotchas

• project_id required: All operations require a project ID. List projects first.
• Customer identifiers: Customers are identified by app_user_id; ensure consistent IDs across platforms.