---
title: subscriptionContractCalculation - GraphQL Admin
description: >-
  Returns a subscription contract calculation by ID. Use this query to poll a

  calculation started by
  [`subscriptionContractCreateCalculate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractCreateCalculate),
  [`subscriptionContractUpdateCalculate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractUpdateCalculate),
  or
  [`subscriptionBillingCycleContractEditCalculate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleContractEditCalculate)

  until it succeeds or fails.


  The result resolves to a pending, succeeded, or failure type. Commit a

  succeeded calculation with the
  [`subscriptionContractCalculationCommit`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractCalculationCommit)
  mutation.


  Learn how to [build a subscription
  contract](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/build-a-subscription-contract).
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/queries/subscriptionContractCalculation
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/queries/subscriptionContractCalculation.md
api_name: admin
api_type: graphql
type: query
---

# subscription​Contract​Calculation

query

Requires `read_own_subscription_contracts` access scope. Also: The user must have manage\_orders\_information permission.

Returns a subscription contract calculation by ID. Use this query to poll a calculation started by [`subscriptionContractCreateCalculate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractCreateCalculate), [`subscriptionContractUpdateCalculate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractUpdateCalculate), or [`subscriptionBillingCycleContractEditCalculate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleContractEditCalculate) until it succeeds or fails.

The result resolves to a pending, succeeded, or failure type. Commit a succeeded calculation with the [`subscriptionContractCalculationCommit`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractCalculationCommit) mutation.

Learn how to [build a subscription contract](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/build-a-subscription-contract).

## Arguments

* id

  [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  required

  The ID of the Subscription Contract Calculation to return.

***

## Possible returns

* Subscription​Contract​Calculation

  [Subscription​Contract​Calculation](https://shopify.dev/docs/api/admin-graphql/latest/unions/SubscriptionContractCalculation)

  The result of a subscription contract calculation, returned by the [`subscriptionContractCalculation`](https://shopify.dev/docs/api/admin-graphql/latest/queries/subscriptionContractCalculation) query. Because calculations run asynchronously, the concrete type reflects the calculation's current state: `SubscriptionContractCalculationPending` while it's still processing, `SubscriptionContractCalculationSuccess` once it's ready to commit, or `SubscriptionContractCalculationFailure` if it failed, whose `errors` field describes what went wrong. Poll the query until the type is no longer pending.

  * [Subscription​Contract​Calculation​Failure](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionContractCalculationFailure)

    OBJECT

    A subscription contract calculation that has failed.

  * [Subscription​Contract​Calculation​Pending](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionContractCalculationPending)

    OBJECT

    A subscription contract calculation that is still processing asynchronously.

  * [Subscription​Contract​Calculation​Success](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionContractCalculationSuccess)

    OBJECT

    A subscription contract calculation that has completed successfully.

***

## Examples

* ### subscriptionContractCalculation reference