---
title: SubscriptionBillingCycle - Customer API
description: The billing cycle of a subscription.
api_version: unstable
api_name: customer
source_url:
  html: https://shopify.dev/docs/api/customer/unstable/objects/SubscriptionBillingCycle
  md: https://shopify.dev/docs/api/customer/unstable/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/unstable/scalars/DateTime)

  non-null

  The expected date of the billing attempt.

* cycle​End​At

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

  non-null

  The end date of the billing cycle.

* cycle​Index

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

  non-null

  The index of the billing cycle.

* cycle​Start​At

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

  non-null

  The start date of the billing cycle.

* edited

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

  non-null

  Whether the billing cycle was edited.

* skipped

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

  non-null

  Whether the billing cycle was skipped.

* status

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

***

## Mutations

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

  mutation

  Skips a Subscription Billing Cycle.

  * billing​Cycle​Input

    [Subscription​Billing​Cycle​Input!](https://shopify.dev/docs/api/customer/unstable/input-objects/SubscriptionBillingCycleInput)

    required

    ### Arguments

    The input object for selecting and using billing cycles.

  ***

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

  mutation

  Unskips a Subscription Billing Cycle.

  * billing​Cycle​Input

    [Subscription​Billing​Cycle​Input!](https://shopify.dev/docs/api/customer/unstable/input-objects/SubscriptionBillingCycleInput)

    required

    ### Arguments

    The input object for selecting and using billing cycles.

  ***

***

## SubscriptionBillingCycle Mutations

### Mutated by

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