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

# 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[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  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[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  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[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  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)