--- title: SubscriptionContract - Customer API description: A Subscription Contract. api_version: 2025-10 api_name: customer type: object api_type: graphql source_url: html: https://shopify.dev/docs/api/customer/latest/objects/subscriptioncontract md: https://shopify.dev/docs/api/customer/latest/objects/subscriptioncontract.md --- # Subscription​Contract object A Subscription Contract. ## Fields * billing​Policy [Subscription​Billing​Policy!](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionBillingPolicy) non-null The billing policy associated with the subscription contract. * created​At [Date​Time!](https://shopify.dev/docs/api/customer/latest/scalars/DateTime) non-null The date and time when the subscription contract was created. * currency​Code [Currency​Code!](https://shopify.dev/docs/api/customer/latest/enums/CurrencyCode) non-null The currency used for the subscription contract. * custom​Attributes [\[Attribute!\]!](https://shopify.dev/docs/api/customer/latest/objects/Attribute) non-null A list of custom attributes to be added to the generated orders. * delivery​Method [Subscription​Delivery​Method](https://shopify.dev/docs/api/customer/latest/unions/SubscriptionDeliveryMethod) The delivery method for each billing of the subscription contract. * delivery​Policy [Subscription​Delivery​Policy!](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionDeliveryPolicy) non-null The delivery policy associated with the subscription contract. * delivery​Price [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2) non-null The delivery price for each billing of the subscription contract. * discounts [Subscription​Discount​Connection](https://shopify.dev/docs/api/customer/latest/connections/SubscriptionDiscountConnection) The list of subscription discounts associated with the subscription contract. * id [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A globally-unique ID. * last​Billing​Attempt​Error​Type [Subscription​Contract​Last​Billing​Error​Type](https://shopify.dev/docs/api/customer/latest/enums/SubscriptionContractLastBillingErrorType) The last billing error type of the contract. * last​Payment​Status [Subscription​Contract​Last​Payment​Status](https://shopify.dev/docs/api/customer/latest/enums/SubscriptionContractLastPaymentStatus) The current status of the last payment. * lines [Subscription​Line​Connection!](https://shopify.dev/docs/api/customer/latest/connections/SubscriptionLineConnection) non-null A list of subscription lines associated with the subscription contract. * lines​Count [Count](https://shopify.dev/docs/api/customer/latest/objects/Count) The number of lines associated with the subscription contract. * next​Billing​Date [Date​Time](https://shopify.dev/docs/api/customer/latest/scalars/DateTime) The next billing date for the subscription contract. * note [String](https://shopify.dev/docs/api/customer/latest/scalars/String) A note that will be applied to the generated orders. * orders [Order​Connection!](https://shopify.dev/docs/api/customer/latest/connections/OrderConnection) non-null A list of the subscription contract's orders. * origin​Order [Order](https://shopify.dev/docs/api/customer/latest/objects/Order) The order from which the contract originated. * revision​Id [Unsigned​Int64!](https://shopify.dev/docs/api/customer/latest/scalars/UnsignedInt64) non-null The revision ID of the contract. * status [Subscription​Contract​Subscription​Status!](https://shopify.dev/docs/api/customer/latest/enums/SubscriptionContractSubscriptionStatus) non-null The current status of the subscription contract. * upcoming​Billing​Cycles [Subscription​Billing​Cycle​Connection!](https://shopify.dev/docs/api/customer/latest/connections/SubscriptionBillingCycleConnection) non-null The upcoming billing cycles on the subscription contract. * updated​At [Date​Time!](https://shopify.dev/docs/api/customer/latest/scalars/DateTime) non-null The date and time when the subscription contract was updated. *** ## Map ### Fields and connections with this object * {}[Customer.subscriptionContract](https://shopify.dev/docs/api/customer/latest/objects/Customer#field-subscriptionContract) * {}[Customer.subscriptionContracts](https://shopify.dev/docs/api/customer/latest/objects/Customer#field-subscriptionContracts) * {}[Order.subscriptionContracts](https://shopify.dev/docs/api/customer/latest/objects/Order#field-subscriptionContracts) * <->[SubscriptionContractConnection.nodes](https://shopify.dev/docs/api/customer/latest/connections/SubscriptionContractConnection#field-nodes) * {}[SubscriptionContractEdge.node](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionContractEdge#field-node) *** ## Mutations * [subscription​Contract​Activate](https://shopify.dev/docs/api/customer/latest/mutations/subscriptionContractActivate) mutation Activates a Subscription Contract. Contract status must be either active, paused, or failed. * [subscription​Contract​Cancel](https://shopify.dev/docs/api/customer/latest/mutations/subscriptionContractCancel) mutation Cancels a Subscription Contract. * [subscription​Contract​Pause](https://shopify.dev/docs/api/customer/latest/mutations/subscriptionContractPause) mutation Pauses a Subscription Contract. * [subscription​Contract​Select​Delivery​Method](https://shopify.dev/docs/api/customer/latest/mutations/subscriptionContractSelectDeliveryMethod) mutation Selects an option from a delivery options result and updates the delivery method on a Subscription Contract. *** ## <\~> SubscriptionContract Mutations ### Mutated by * <\~>[subscription​Contract​Activate](https://shopify.dev/docs/api/customer/latest/mutations/subscriptionContractActivate) * <\~>[subscription​Contract​Cancel](https://shopify.dev/docs/api/customer/latest/mutations/subscriptionContractCancel) * <\~>[subscription​Contract​Pause](https://shopify.dev/docs/api/customer/latest/mutations/subscriptionContractPause) * <\~>[subscription​Contract​Select​Delivery​Method](https://shopify.dev/docs/api/customer/latest/mutations/subscriptionContractSelectDeliveryMethod) *** ## Interfaces * * [Node](https://shopify.dev/docs/api/customer/latest/interfaces/Node) interface * [Subscription​Contract​Base](https://shopify.dev/docs/api/customer/latest/interfaces/SubscriptionContractBase) interface *** ## ||-SubscriptionContract Implements ### Implements * ||-[Node](https://shopify.dev/docs/api/customer/latest/interfaces/Node) * ||-[Subscription​Contract​Base](https://shopify.dev/docs/api/customer/latest/interfaces/SubscriptionContractBase)