Querying Subscriptions

This guide covers all subscription query capabilities provided by WooGraphQL Pro.

Query a specific subscription by ID:

query GetSubscription($id: ID!) {
  customer {
    subscription(id: $id) {
      id
      databaseId
      status
      billingPeriod
      billingInterval
      startDate
      trialDate
      lastPaymentDate
      nextPaymentDate
      endDate
      cancelledDate
      requiresManualRenewal
      total
      subtotal
      totalTax
    }
  }
}

Query all subscriptions for the authenticated customer:

query GetMySubscriptions($first: Int, $after: String) {
  customer {
    subscriptions(first: $first, after: $after) {
      pageInfo {
        hasNextPage
        endCursor
      }
      nodes {
        id
        databaseId
        status
        billingPeriod
        billingInterval
        nextPaymentDate
        total
      }
    }
  }
}

query GetActiveSubscriptions {
  customer {
    subscriptions(where: { status: ACTIVE }) {
      nodes {
        id
        status
        nextPaymentDate
      }
    }
  }
}

Query the products included in a subscription:

query GetSubscriptionLineItems($id: ID!) {
  customer {
    subscription(id: $id) {
      lineItems {
        nodes {
          product {
            node {
              id
              name
              ... on SubscriptionProduct {
                subscriptionPrice
                subscriptionPeriod
              }
            }
          }
          quantity
          total
          subtotal
        }
      }
    }
  }
}

query GetSubscriptionBilling($id: ID!) {
  customer {
    subscription(id: $id) {
      billing {
        firstName
        lastName
        company
        address1
        address2
        city
        state
        postcode
        country
        email
        phone
      }
    }
  }
}

Query orders associated with a subscription:

query GetSubscriptionOrders($id: ID!) {
  customer {
    subscription(id: $id) {
      orders {
        nodes {
          id
          databaseId
          status
          total
          date
        }
      }
    }
  }
}

Check if a subscription was resubscribed from another:

query GetResubscriptionInfo($id: ID!) {
  customer {
    subscription(id: $id) {
      resubscribedFrom {
        id
        status
      }
      resubscribedSubscription {
        id
        status
      }
    }
  }
}

availableForMigration lists the subscription products this subscription can switch to. Eligibility mirrors WooCommerce Subscriptions' own switch rules (wcs_is_product_switchable_type), so it honors the store's switching settings — WooCommerce → Settings → Subscriptions → "Allow Switching" ("Between Subscription Variations" / "Between Grouped Subscriptions") — and excludes products already on the subscription. It is not affected by a product's purchase-limit setting.

The connection accepts the standard product connection arguments, so results can be filtered, ordered, and paginated — e.g. limit to in-stock products. Each edge also exposes itemId, the subscription line item the target applies to.

query GetMigrationOptions($id: ID!) {
  customer {
    subscription(id: $id) {
      availableForMigration(first: 20, where: { stockStatus: IN_STOCK }) {
        edges {
          itemId
          node {
            id
            name
            ... on SubscriptionProduct {
              subscriptionPrice
              subscriptionPeriod
            }
          }
        }
      }
    }
  }
}

Query subscriptions created from a specific order:

query GetOrderSubscriptions($orderId: ID!) {
  order(id: $orderId, idType: DATABASE_ID) {
    subscriptions {
      nodes {
        id
        status
        nextPaymentDate
      }
    }
  }
}

A comprehensive query for subscription details:

query GetFullSubscription($id: ID!) {
  customer {
    subscription(id: $id) {
      # Identity
      id
      databaseId
      status

      # Billing Schedule
      billingPeriod
      billingInterval
      requiresManualRenewal

      # Dates
      startDate
      trialDate
      lastPaymentDate
      nextPaymentDate
      endDate
      cancelledDate

      # Totals
      total
      subtotal
      totalTax

      # Billing Address
      billing {
        firstName
        lastName
        email
        phone
        address1
        city
        state
        postcode
        country
      }

      # Products
      lineItems {
        nodes {
          product {
            node {
              id
              name
              image {
                sourceUrl
              }
            }
          }
          quantity
          total
        }
      }

      # Related
      orders(first: 5) {
        nodes {
          id
          status
          total
          date
        }
      }

      # Migration
      availableForMigration {
        nodes {
          id
          name
        }
      }
    }
  }
}

Subscription queries require authentication. The customer can only query their own subscriptions. Admin users can query any subscription.

• Subscription Mutations - Managing subscriptions
• Subscription Products - Product type queries