---
title: SubscriptionBillingCycle - GraphQL Admin
description: A subscription billing cycle.
api_version: 2026-01
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

* billingAttemptExpectedDate
* billingAttempts
* cycleEndAt
* cycleIndex
* cycleStartAt
* edited
* editedContract
* skipped
* sourceContract
* status

***

## 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

* subscriptionBillingCycle
* subscriptionBillingCycleBulkResults
* subscriptionBillingCycles

***

## 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/subscriptionBillingCycleBulkResults)
* [subscription​Billing​Cycles](https://shopify.dev/docs/api/admin-graphql/latest/queries/subscriptionBillingCycles)

***

## Mutations

* subscriptionBillingCycleEditDelete
* subscriptionBillingCycleEditsDelete
* subscriptionBillingCycleScheduleEdit
* subscriptionBillingCycleSkip
* subscriptionBillingCycleUnskip

***

## 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)