---
title: SubscriptionBillingCycle - GraphQL Admin
description: A subscription billing cycle.
api_version: 2025-10
api_name: admin
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingCycle
  md: https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingCycle.md
---

# Subscription​Billing​Cycle

object

Requires the `read_own_subscription_contracts` or `write_own_subscription_contracts` scope.

A subscription billing cycle.

## Fields

* billing​Attempt​Expected​Date

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

  non-null

  The date on which the billing attempt is expected to be made.

* billing​Attempts

  [Subscription​Billing​Attempt​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/SubscriptionBillingAttemptConnection)

  non-null

  The list of billing attempts associated with the billing cycle.

* cycle​End​At

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

  non-null

  The end date of the billing cycle.

* cycle​Index

  [Int!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int)

  non-null

  The index of the billing cycle.

* cycle​Start​At

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

  non-null

  The start date of the billing cycle.

* edited

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

  non-null

  Whether this billing cycle was edited.

* edited​Contract

  [Subscription​Billing​Cycle​Edited​Contract](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingCycleEditedContract)

  The active edited contract for the billing cycle.

* skipped

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

  non-null

  Whether this billing cycle was skipped.

* source​Contract

  [Subscription​Contract!](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionContract)

  non-null

  The subscription contract that the billing cycle belongs to.

* status

  [Subscription​Billing​Cycle​Billing​Cycle​Status!](https://shopify.dev/docs/api/admin-graphql/latest/enums/SubscriptionBillingCycleBillingCycleStatus)

  non-null

  The status of the billing cycle.

***

## Map

### Fields and connections with this object

* <->[SubscriptionBillingCycleConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/SubscriptionBillingCycleConnection#returns-nodes)
* {}[SubscriptionBillingCycleEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingCycleEdge#field-SubscriptionBillingCycleEdge.fields.node)
* {}[SubscriptionBillingCycleEditedContract.billingCycles](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingCycleEditedContract#field-SubscriptionBillingCycleEditedContract.fields.billingCycles)
* {}[SubscriptionDraft.billingCycle](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionDraft#field-SubscriptionDraft.fields.billingCycle)
* {}[SubscriptionDraft.concatenatedBillingCycles](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionDraft#field-SubscriptionDraft.fields.concatenatedBillingCycles)

***

## Queries

* [subscription​Billing​Cycle](https://shopify.dev/docs/api/admin-graphql/latest/queries/subscriptionBillingCycle)

  query

  Returns a subscription billing cycle found either by cycle index or date.

* [subscription​Billing​Cycle​Bulk​Results](https://shopify.dev/docs/api/admin-graphql/latest/queries/subscriptionBillingCycleBulkResults)

  query

  Retrieves the results of the asynchronous job for the subscription billing cycle bulk action based on the specified job ID. This query can be used to obtain the billing cycles that match the criteria defined in the subscriptionBillingCycleBulkSearch and subscriptionBillingCycleBulkCharge mutations.

* [subscription​Billing​Cycles](https://shopify.dev/docs/api/admin-graphql/latest/queries/subscriptionBillingCycles)

  query

  Returns subscription billing cycles for a contract ID.

***

## \<?>SubscriptionBillingCycle Queries

### Queried by

* \<?>[subscription​Billing​Cycle](https://shopify.dev/docs/api/admin-graphql/latest/queries/SubscriptionBillingCycle)
* \<?>[subscription​Billing​Cycle​Bulk​Results](https://shopify.dev/docs/api/admin-graphql/latest/queries/SubscriptionBillingCycleConnection)
* \<?>[subscription​Billing​Cycles](https://shopify.dev/docs/api/admin-graphql/latest/queries/SubscriptionBillingCycleConnection)

***

## Mutations

* [subscription​Billing​Cycle​Edit​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleEditDelete)

  mutation

  Delete the schedule and contract edits of the selected subscription billing cycle.

* [subscription​Billing​Cycle​Edits​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleEditsDelete)

  mutation

  Delete the current and future schedule and contract edits of a list of subscription billing cycles.

* [subscription​Billing​Cycle​Schedule​Edit](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleScheduleEdit)

  mutation

  Modify the schedule of a specific billing cycle.

* [subscription​Billing​Cycle​Skip](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleSkip)

  mutation

  Skips a Subscription Billing Cycle.

* [subscription​Billing​Cycle​Unskip](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleUnskip)

  mutation

  Unskips a Subscription Billing Cycle.

***

## <\~> SubscriptionBillingCycle Mutations

### Mutated by

* <\~>[subscription​Billing​Cycle​Edit​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleEditDelete)
* <\~>[subscription​Billing​Cycle​Edits​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleEditsDelete)
* <\~>[subscription​Billing​Cycle​Schedule​Edit](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleScheduleEdit)
* <\~>[subscription​Billing​Cycle​Skip](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleSkip)
* <\~>[subscription​Billing​Cycle​Unskip](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleUnskip)