---
title: >-
  New creation, update, and status filters for subscriptionContracts - 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-contracts-filters'
  md: 'https://shopify.dev/changelog/posts/subscription-contracts-filters.md'
metadata:
  effectiveApiVersion: 2025-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
    - displayName: Customer Account API
      handle: customer-account-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-01-24T13:22:54-05:00'
  postedAt: '2025-01-25T12:00:00-05:00'
  updatedAt: '2025-02-05T13:49:34-05:00'
  effectiveAt: '2025-01-25T12:00:00-05:00'
---

January 25, 2025

# New creation, update, and status filters for subscriptionContracts

DateJanuary 25, 2025

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

FlagsNew

SurfacesAPI

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

As of API version 2025-04, you can now sort the subscriptionContracts query results by `created_at`, `updated_at`, and `status` filters in both the admin and customer account APIs. The ability to sort subscription contracts simplifies tracking and prioritizing by allowing you to quickly organize and view information based on when they were created, updated, or their current status.

For more information, please refer to our documentation:

* Learn how to [implement sorting](https://shopify.dev/docs/api/admin-graphql/2025-04/queries/subscriptionContracts#argument-query) in the admin API.
* Explore [sorting filters](https://shopify.dev/docs/api/customer/2025-04/objects/Customer#connection-subscriptioncontracts) in the customer account API.