Skip to main content
Anchor to CancelledSubscription

CancelledSubscription

object

Represents a pricing subscription that was cancelled.

•AppReference!
non-null

The app that provides this subscription.

•AppPricingInterval!
non-null

The frequency at which the shop is billed for an app subscription.

•Boolean!
non-null

Returns true if the subscription will be cancelled at the end of the cycle.

•DateTime

The date and time when the subscription was cancelled. Returns null for deferred cancellations.

•BillingCycle

The current billing cycle for the subscription. Returns null if the subscription is still in trial.

•[SubscriptionItem!]!
non-null

The subscription items included in this subscription.

Anchor to legacySubscriptionIdlegacySubscriptionId
•ID

The ID of the legacy AppSubscription object accessible via Admin API.

•PendingUpdate

Pending updates that will be applied at the next billing cycle. Returns null if no pending updates.

•ShopReference!
non-null

The shop that owns this subscription.

•DateTime

The date and time when the trial period ends. Returns null if no active trial.


Was this section helpful?

•mutation

Cancels an app subscription.

Arguments

•ID!
required

The id of the app. Example value: gid://shopify/App/123.

•Boolean!
required

Whether to defer cancellation until the end of the current billing cycle.

•Boolean!
required

Whether to issue prorated credits for the unused portion of the subscription. Cannot be used together with skipFinalUsageCharge.

•ID!
required

The id of the shop. Example value: gid://shopify/Shop/456.

Anchor to skipFinalUsageChargeskipFinalUsageCharge
•Boolean!
required

Whether to skip the final usage charge when cancelling. Only applicable to usage-billed subscriptions. Cannot be used together with prorate.



Was this section helpful?