---
title: SubscriptionBillingCycle - Customer API
description: The billing cycle of a subscription.
api_version: 2025-10
api_name: customer
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/customer/latest/objects/subscriptionbillingcycle
  md: https://shopify.dev/docs/api/customer/latest/objects/subscriptionbillingcycle.md
---

# Subscription​Billing​Cycle

object

The billing cycle of a subscription.

## Fields

* billing​Attempt​Expected​Date

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

  non-null

  The expected date of the billing attempt.

* cycle​End​At

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

  non-null

  The end date of the billing cycle.

* cycle​Index

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

  non-null

  The index of the billing cycle.

* cycle​Start​At

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

  non-null

  The start date of the billing cycle.

* edited

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

  non-null

  Whether the billing cycle was edited.

* skipped

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

  non-null

  Whether the billing cycle was skipped.

* status

  [Subscription​Billing​Cycle​Billing​Cycle​Status!](https://shopify.dev/docs/api/customer/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/customer/latest/connections/SubscriptionBillingCycleConnection#field-nodes)
* {}[SubscriptionBillingCycleEdge.node](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionBillingCycleEdge#field-node)
* {}[SubscriptionContract.upcomingBillingCycles](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionContract#field-upcomingBillingCycles)

***

## Mutations

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

  mutation

  Skips a Subscription Billing Cycle.

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

  mutation

  Unskips a Subscription Billing Cycle.

***

## <\~> SubscriptionBillingCycle Mutations

### Mutated by

* <\~>[subscription​Billing​Cycle​Skip](https://shopify.dev/docs/api/customer/latest/mutations/subscriptionBillingCycleSkip)
* <\~>[subscription​Billing​Cycle​Unskip](https://shopify.dev/docs/api/customer/latest/mutations/subscriptionBillingCycleUnskip)