Name: rc-revenuecat-api-quick-reference
Author: revenuecat

Use this skill as a quick reference for the RevenueCat Android SDK 10.x and REST API. Covers SDK init, common Purchases calls, CustomerInfo / Offerings access patterns, and the most used REST endpoints.

RevenueCat API Quick Reference Phase 0: Intent Use this skill when you need a fast lookup of a RevenueCat API surface while writing Android code or server logic. Typical questions you answer from here: Which builder option controls a given Purchases.configure behavior? What is the return type and signature of awaitPurchase , awaitOfferings , awaitCustomerInfo , awaitRestore , awaitLogIn , awaitLogOut ? How do I read offering, package, product, entitlement fields? Which PurchasesErrorCode should I branch on? Which listener callback do I register for customer info updates? Do not use this skill as a deep tutorial. Reach for the feature specific skills (purchase flow, configuring the SDK, error handling, subscription states) when you need step by step guidance or design rationale. Phase 1: Locate Decide SDK surface vs REST surface before you search the tables. Route to the SDK (client side, Android app code): Code runs inside the Android app, in an Activity , ViewModel , or background worker bundled with your app. You need to launch a purchase, restore purchases, read cached CustomerInfo , fetch Offerings , identify or log out a user, or listen for updates. You want entitlement gating in the UI. Route to the REST API (server side): Code runs on your backend, in a webhook handler, in an admin tool, or in a scheduled job. You need to grant or revoke a promotional entitlement, override a subscription, look up a subscriber from another service, refund, or deliver events to another system. You are integrating with a system that cannot embed the SDK. The tables in this skill cover the Android SDK 10.x surface from appendix A verbatim. For REST endpoint paths, authentication, and payloads, see the [full appendix on revenuecat.com](https://www.revenuecat.com/guides/revenuecat android sdk/appendix revenuecat api quick reference) together with the backend and webhooks skills, and treat this file as the SDK index. Phase 2: Reference Tables SDK Initialization Core Operations (Coroutine) Offerings Structure Entitlements Error Handling Listeners Phase 3: Typical Snippets Gate a feature on an entitlement. Buy the monthly package from the current offering. Handle cancel vs real failure. Force a fresh CustomerInfo fetch after a server side grant. Log in an identified user and detect first login. React to background entitlement changes. References [Full chapter](https://www.revenuecat.com/guides/revenuecat android sdk/appendix revenuecat api quick reference) Related skills in this repo: [rc configuring the sdk](../rc configuring the sdk/), [rc purchase flow](../rc purchase flow/), [rc error handling](../rc error handling/), [rc subscription states](../rc subscription states/), [rc backend](../rc backend/), [rc webhooks](../rc webhooks/).