---
title: ActiveSubscription - Partner API
description: Represents an active pricing subscription between a shop and an app.
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/partner/latest/objects/ActiveSubscription'
  md: 'https://shopify.dev/docs/api/partner/latest/objects/ActiveSubscription.md'
api_name: partner
api_type: graphql
type: object
---

# Active​Subscription

object

Represents an active pricing subscription between a shop and an app.

## Fields

* app

  [App​Reference!](https://shopify.dev/docs/api/partner/latest/objects/AppReference)

  non-null

  The app that provides this subscription.

* billing​Period

  [App​Pricing​Interval!](https://shopify.dev/docs/api/partner/latest/enums/AppPricingInterval)

  non-null

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

* cancel​At​End​Of​Cycle

  [Boolean!](https://shopify.dev/docs/api/partner/latest/scalars/Boolean)

  non-null

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

* current​Billing​Cycle

  [Billing​Cycle](https://shopify.dev/docs/api/partner/latest/objects/BillingCycle)

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

* items

  [\[Subscription​Item!\]!](https://shopify.dev/docs/api/partner/latest/objects/SubscriptionItem)

  non-null

  The subscription items included in this subscription.

* legacy​Subscription​Id

  [ID](https://shopify.dev/docs/api/partner/latest/scalars/ID)

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

* pending​Update

  [Pending​Update](https://shopify.dev/docs/api/partner/latest/objects/PendingUpdate)

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

* shop

  [Shop​Reference!](https://shopify.dev/docs/api/partner/latest/objects/ShopReference)

  non-null

  The shop that owns this subscription.

* trial​Ends​At

  [Date​Time](https://shopify.dev/docs/api/partner/latest/scalars/DateTime)

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

***

## Map

No referencing types

***

## Queries

* [active​Subscription](https://shopify.dev/docs/api/partner/latest/queries/activeSubscription)

  query

  The active managed pricing subscription for a shop on a given app.

  * app​Id

    [ID!](https://shopify.dev/docs/api/partner/latest/scalars/ID)

    required

    ### Arguments

    The ID of the app to get the active subscription for. Example value: `gid://shopify/App/1234`.

  * shop​Id

    [ID!](https://shopify.dev/docs/api/partner/latest/scalars/ID)

    required

    The ID of the shop to get the active subscription for. Example value: `gid://shopify/Shop/1234`.

  ***

***

## ActiveSubscription Queries

### Queried by

* [active​Subscription](https://shopify.dev/docs/api/partner/latest/queries/activeSubscription)