storekit__get_subscription_statuses
Read-only
Get the status of every subscription a customer holds, including expiry date, auto-renew state, billing retry and grace period.
Instructions
Get the status of every subscription a customer holds, including expiry date, auto-renew state, billing retry and grace period. Apple returns those fields inside SIGNED payloads (JWS strings) on each item, so verify and decode them before reading. Use this for entitlement checks. [App Store Server API]
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app | No | Which app: its name, bundle ID or Apple ID. Optional when the account has one app or ASC_BUNDLE_ID is set. | |
| status | No | Filter by status: 1=Active, 2=Expired, 3=BillingRetry, 4=GracePeriod, 5=Revoked. | |
| environment | No | Which App Store environment to query. Defaults to the server-configured environment (ASC_ENVIRONMENT). A transaction ID belongs to one environment only. | |
| transaction_id | Yes | Any transaction ID belonging to the customer. |