How do I get all BillingCycles for a Subscription Contract

Topic summary

A developer is working with Shopify’s subscription billing cycles and has successfully used subscriptionBillingCycleScheduleEdit to skip a billing cycle.

Current Challenge:

  • Needs to retrieve all billing cycles for a given subscription contract
  • Goal is to determine whether to trigger a billing attempt based on data from previous cycles

Solution Provided:

  • Another user suggests using the subscriptionBillingCycles query from Shopify’s Admin GraphQL API
  • Reference link provided to the API documentation

The question appears to be answered with a direct API solution, though no confirmation of resolution is indicated.

Summarized with AI on November 23. AI used: claude-sonnet-4-5-20250929.

Hi,

As per this doc https://shopify.dev/apps/subscriptions/billing-cycles, I have usedsubscriptionBillingCycleScheduleEdit to skip a billing cycle. Once that’s done, how do I get all the billing cycles for a given contract? so that I can act accordingly, ie. to decide whether or not to trigger a billingAttempt based on the data coming back for a cycle.

Thanks in advance.

Hi @thanh_mohc .

I believe you are looking for the subscriptionBillingCycles query?

Best.

1 Like