---
title: SubscriptionContractSubscriptionStatus - Customer API
description: The status of a subscription.
api_version: 2026-04
source_url:
  html: >-
    https://shopify.dev/docs/api/customer/latest/enums/SubscriptionContractSubscriptionStatus
  md: >-
    https://shopify.dev/docs/api/customer/latest/enums/SubscriptionContractSubscriptionStatus.md
api_name: customer
api_type: graphql
type: enum
---

# Subscription​Contract​Subscription​Status

enum

The status of a subscription.

## Valid values

* ACTIVE

  The contract is active and is continuing per its policies.

* CANCELLED

  The contract was ended by an unplanned customer action.

* EXPIRED

  The contract has ended per the expected circumstances. All billing and delivery cycles of the subscriptions have been executed.

* FAILED

  The contract has ended because billing failed and no further billing attempts are expected.

* PAUSED

  The contract is temporarily paused and is expected to resume in the future.

* STALE

  The contract has expired due to inactivity.

***

## Fields

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

  OBJECT

  A Subscription Contract.

***

## Map

### Fields with this enum

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