---
title: >-
  Customer Account API now includes subscription discount data - Shopify
  developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/subscription-discounts-are-now-available-in-the-customer-api
  md: >-
    https://shopify.dev/changelog/posts/subscription-discounts-are-now-available-in-the-customer-api.md
metadata:
  effectiveApiVersion: 2025-07
  affectedApi:
    - displayName: Customer Account API
      handle: customer-account-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-05-21T10:53:37-04:00'
  postedAt: '2025-07-01T12:00:00-04:00'
  updatedAt: '2025-06-17T20:56:52-04:00'
  effectiveAt: '2025-07-01T12:00:00-04:00'
---

July 1, 2025

# Customer Account API now includes subscription discount data

DateJuly 1, 2025

Version[2025-07](https://shopify.dev/changelog?api_version=2025-07)

FlagsNew

SurfacesAPI

Affected APIs[Customer Account API](https://shopify.dev/changelog?api_type=customer-account-graphql)

The [Customer Account API](https://shopify.dev/docs/api/customer) now includes a [discounts connection](https://shopify.dev/docs/api/customer/2025-07/connections/SubscriptionDiscountConnection) on customer subscription contracts, mirroring functionality that already exists in the Admin API.

What's new:

* Query subscription discount details directly from the Customer Account API.
* Access discount types, values, and line-item allocations through the [discounts](https://shopify.dev/docs/api/admin-graphql/latest/queries/subscriptioncontract#returns-SubscriptionContract.fields.discounts) field returned by the `SubscriptionContract` query.
* No changes to existing Admin API functionality.

How to use it: You can now examine subscription discounts in customer storefronts using the `discounts` field on subscription contracts. This returns the same discount information available through the Admin API, including:

* Discount amounts and percentages
* Which subscription lines the discounts apply to
* Discount allocation details

This enhancement enables the creation of more comprehensive subscription management experiences, allowing customers to see precisely how discounts affect their subscription pricing.

Learn more

* [`SubscriptionDiscountConnection` documentation](https://shopify.dev/docs/api/customer/unstable/connections/SubscriptionDiscountConnection)
* [GraphQL Customer Account API overview](https://shopify.dev/docs/api/customer)