rc-cli-usage

name	rc-cli-usage
description	Guidance for using rc-cli (public V2 API) and rc-internal (dashboard API). Covers authentication, command structure, output formats, and flag conventions for both CLIs. Use when asked about rc, rc-cli, rc-internal, RevenueCat auth, API keys, session cookies, or general CLI usage.

rc-cli Usage

Two CLIs, Two APIs

CLI	Auth	Base URL	Commands
rc	API key (sk_…) from rc config	api.revenuecat.com/v2	rc subscribers, rc products, rc offerings, rc apps, rc entitlements, rc charts, rc config, rc utilities
rc-internal	Session cookie from rc-internal login	app.revenuecat.com/internal/v1	rc-internal internal projects, rc-internal internal offerings, rc-internal internal entitlements, rc-internal internal products, rc-internal internal apps, rc-internal internal charts, rc-internal internal experiments, rc-internal internal lists, rc-internal internal collaborators, rc-internal internal apikeys, rc-internal internal audit, rc-internal internal stores-status, rc-internal internal utilities

rc (Public V2 API)

Authentication

rc config
# Enter your API key and project ID

Credentials stored in ~/.revenuerc.

Commands

rc subscribers list                          # List subscribers
rc subscribers get <customer_id>              # Get subscriber details
rc subscribers entitlements <customer_id>    # Get subscriber entitlements
rc subscribers subscriptions <customer_id>   # Get subscriber subscriptions

rc products list                             # List products
rc offerings list                            # List offerings
rc apps list                                 # List apps
rc entitlements list                         # List entitlements

rc charts revenue                            # Revenue chart
rc charts overview                           # Overview chart

rc config show                               # Show current config
rc config unset                              # Clear config

rc utilities countries                        # List supported countries

rc api GET '/projects/{project_id}/offerings'  # Direct V2 API access
rc api POST '/projects/{project_id}/offerings' -d '{"identifier":"...","name":"..."}'

rc-internal (Dashboard API)

Authentication

rc-internal login
# Enter your RevenueCat email and password

Session auto-refreshes. Stored in ~/.rc-internal/.

Projects

rc-internal internal projects list                        # List all accessible projects
rc-internal internal projects use -i <project_id>         # Set default project
rc-internal internal projects create -n "My App"          # Create project
rc-internal internal projects get -i <project_id>          # Get project details

Offerings

rc-internal internal offerings list                              # List all offerings
rc-internal internal offerings list --platform IOS              # Filter by platform
rc-internal internal offerings get -o <offering_id>              # Get details
rc-internal internal offerings create -i weekly -n "Weekly"      # Create
rc-internal internal offerings update -o <offering_id> -n "New Name"
rc-internal internal offerings update -o <offering_id> --metadata '{"key":"value"}'
rc-internal internal offerings duplicate -o <offering_id> -i new-id -n "New Name"
rc-internal internal offerings set-current -o <offering_id>       # Set as default
rc-internal internal offerings archive -o <offering_id>
rc-internal internal offerings delete -o <offering_id>

Entitlements

rc-internal internal entitlements list
rc-internal internal entitlements create -i pro -n "Pro Tier"
rc-internal internal entitlements attach-products -e <id> --product-ids <id1>,<id2>
rc-internal internal entitlements detach-products -e <id> --product-ids <id1>
rc-internal internal entitlements archive -e <id>
rc-internal internal entitlements delete -e <id>

Products

rc-internal internal products list                        # Default 100, use --limit 2500 for more
rc-internal internal products create --app-id <id> --product-type subscription --identifier my.weekly --name "Weekly"
rc-internal internal products create --app-id <id> --product-type non_consumable_product --identifier my.tip --name "Tip Jar"
rc-internal internal products update --product-id <id> -n "New Name"

Product types: subscription, non_consumable_product, consumable_product, non_renewing_subscription

Apps

rc-internal internal apps list
rc-internal internal apps subscription-groups -i <app_id>
rc-internal internal apps app-store-products create -i <app_id> --subscription-group-id <group_id> --identifier my.weekly --name "Weekly" --duration ONE_WEEK

Charts

rc-internal internal charts overview          # Project overview
rc-internal internal charts overview --sandbox
rc-internal internal charts overview-all       # All projects
rc-internal internal charts revenue --start-date 2024-01-01 --end-date 2024-12-31
rc-internal internal charts revenue --resolution 0 --sandbox  # 0=daily, 1=weekly, 2=monthly
rc-internal internal charts transactions --start-date 2024-01-01
rc-internal internal charts trials --start-date 2024-01-01

Experiments

rc-internal internal experiments list
rc-internal internal experiments types
rc-internal internal experiments create -n "Price Test" -a <offering_a_id> -b <offering_b_id>
rc-internal internal experiments create -n "Price Test" -a <id> -b <id> --enrollment 50 --primary-metric "Realized LTV per customer"
rc-internal internal experiments get -e <experiment_id>
rc-internal internal experiments pause -e <id>
rc-internal internal experiments resume -e <id>
rc-internal internal experiments stop -e <id>

Other Commands

rc-internal internal lists list                    # Subscriber lists
rc-internal internal lists get -l <list_id>
rc-internal internal lists manifest
rc-internal internal collaborators list
rc-internal internal apikeys list
rc-internal internal audit list
rc-internal internal stores-status
rc-internal internal stores-status stores
rc-internal internal stores-status product-stores
rc-internal internal utilities countries

Global Flags

rc-internal -p <project_id>   # Project ID (required for most commands)

Quick Setup

# For dashboard commands
rc-internal login
rc-internal internal projects list
rc-internal internal projects use -i <project_id>