---
title: SubscriptionBillingPolicy - Customer API
description: The billing policy of a subscription.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/customer/latest/objects/SubscriptionBillingPolicy
  md: >-
    https://shopify.dev/docs/api/customer/latest/objects/SubscriptionBillingPolicy.md
api_name: customer
api_type: graphql
type: object
---

# Subscription​Billing​Policy

object

Requires `customer_read_customers` access scope.

The billing policy of a subscription.

## Fields

* anchors

  [\[Subscription​Anchor!\]!](https://shopify.dev/docs/api/customer/latest/unions/SubscriptionAnchor)

  non-null

  The anchor dates for calculating billing intervals.

* interval

  [Subscription​Interval!](https://shopify.dev/docs/api/customer/latest/enums/SubscriptionInterval)

  non-null

  The type of interval associated with this schedule (e.g. Monthly, Weekly, etc).

* interval​Count

  [Count](https://shopify.dev/docs/api/customer/latest/objects/Count)

  The number of intervals between invoices.

* max​Cycles

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

  The maximum number of cycles after which the subscription ends.

* min​Cycles

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

  The minimum number of cycles required for the subscription.

***

## Map

### Fields with this object

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