---
title: SubscriptionBillingCycleConnection - Customer API
description: >-
  An auto-generated type for paginating through multiple
  SubscriptionBillingCycles.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/customer/latest/connections/SubscriptionBillingCycleConnection
  md: >-
    https://shopify.dev/docs/api/customer/latest/connections/SubscriptionBillingCycleConnection.md
api_name: customer
api_type: graphql
type: connection
---

# Subscription​Billing​Cycle​Connection

connection

An auto-generated type for paginating through multiple SubscriptionBillingCycles.

## Fields with this connection

* [Subscription​Contract.upcomingBillingCycles](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionContract#field-SubscriptionContract.fields.upcomingBillingCycles)

  OBJECT

  A Subscription Contract.

***

## Possible returns

* edges

  [\[Subscription​Billing​Cycle​Edge!\]!](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionBillingCycleEdge)

  non-null

  The connection between the node and its parent. Each edge contains a minimum of the edge's cursor and the node.

* nodes

  [\[Subscription​Billing​Cycle!\]!](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionBillingCycle)

  non-null

  A list of nodes that are contained in SubscriptionBillingCycleEdge. You can fetch data about an individual node, or you can follow the edges to fetch data about a collection of related nodes. At each node, you specify the fields that you want to retrieve.

* page​Info

  [Page​Info!](https://shopify.dev/docs/api/customer/latest/objects/PageInfo)

  non-null

  An object that’s used to retrieve [cursor information](https://shopify.dev/api/usage/pagination-graphql) about the current page.

***

## Map

### Fields with this connection

* [Subscription​Contract.upcomingBillingCycles](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionContract#field-SubscriptionContract.fields.upcomingBillingCycles)

### Possible returns

* [Subscription​Billing​Cycle​Connection.edges](https://shopify.dev/docs/api/customer/latest/connections/SubscriptionBillingCycleConnection#returns-edges)
* [Subscription​Billing​Cycle​Connection.nodes](https://shopify.dev/docs/api/customer/latest/connections/SubscriptionBillingCycleConnection#returns-nodes)
* [Subscription​Billing​Cycle​Connection.pageInfo](https://shopify.dev/docs/api/customer/latest/connections/SubscriptionBillingCycleConnection#returns-pageInfo)