--- 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/subscription-discounts-are-now-available-in-the-customer-api md: https://shopify.dev/changelog/subscription-discounts-are-now-available-in-the-customer-api.md --- [Back to Developer changelog](https://shopify.dev/changelog) July 1, 2025 Tags: * Customer Account API * 2025-07 # Customer Account API now includes subscription discount data 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)