---
title: Introducing the Subscription Billing Cycles API - Shopify developer changelog
description: Shopify’s developer changelog documents all changes to Shopify’s platform. Find the latest news and learn about new platform opportunities.
source_url:
  html: https://shopify.dev/changelog/introducing-the-subscription-billing-cycles-api
  md: https://shopify.dev/changelog/introducing-the-subscription-billing-cycles-api.md
---

[Back to Developer changelog](https://shopify.dev/changelog)

October 1, 2022

Tags:

* API
* 2022-10

# Introducing the Subscription Billing Cycles API

As of GraphQL Admin API version 2022-10, we've introduced Subscription Billing Cycles to the existing Subscriptions Contract APIs so that you can make changes to an upcoming order without affecting the base subscription contract.

This includes:

* The ability to skip a future order.
* The ability to make changes to the line items of an upcoming order, including any additions, quantity changes, or removals.
* The ability to combine the orders of one or more subscriptions contracts in order to save on shipping costs.

Please note that with the introduction of Subscriptions Billing Cycles API, `SubscriptionBillingAttemptCreate` will create a billing attempt for the billing cycle at the `origin_time` if specified. Otherwise, it will be created for the current billing cycle by default.

Alternatively, you can also use `BillingCycleSelector` to select the billing cycle you wish to create billing attempt for.

Learn more about [the API on Shopify.dev](https://shopify.dev/apps/subscriptions/billing-cycles).