App StoreKit CLI
Query App StoreKit APIs using the ask command-line tool.
Prerequisites
ask --version
export ASK_ISSUER_ID='your-issuer-id'
export ASK_PRIVATE_KEY_PATH='/path/to/key.p8'
ask auth statusAuthentication
- Issuer ID and private key from App Store Connect
- Environment variables:
ASK_ISSUER_ID,ASK_PRIVATE_KEY_PATH - Or:
ask auth loginfor interactive setup
In-App Purchases
Products
ask products list --app APP_ID
ask products get PRODUCT_ID --app APP_ID
ask products history --app APP_ID --product PRODUCT_IDSubscriptions
ask subscriptions list --app APP_ID
ask subscriptions get SUBSCRIPTION_ID --app APP_ID
ask subscriptions groups list --app APP_ID
ask subscriptions status --app APP_ID --customer CUSTOMER_IDTransactions
ask transactions history --app APP_ID --customer CUSTOMER_ID
ask transactions verify --app APP_ID --transaction-id TX_ID
ask transactions refund --app APP_ID --transaction-id TX_ID --reason "Customer request"Consumption & Status
ask consumption report --app APP_ID --date 2024-06-01
ask status --app APP_ID --customer CUSTOMER_ID --product PRODUCT_ID
ask entitlements --app APP_ID --customer CUSTOMER_IDNotifications & Events
ask notifications list --app APP_ID --days 7
ask events list --app APP_ID --type SUBSCRIBED --days 30Agent Best Practices
- Customer IDs: Use anonymized identifiers
- Pagination: Use
--cursorfor large result sets - Date ranges: Limit queries to needed timeframe
- Sandbox: Use
--sandboxfor testing environment