Subscription entity allows you fetch information about the subscription and take subscription level actions such as pause subscription, resume subscription, swap line items, etc.
Subscription object
{
"success": true,
"message": "Subscription fetched successfully",
"data": {
"id": 30227744,
"shopifyId": 14074544282,
"originOrderShopifyId": 6427762327706,
"createdAt": "2026-07-02T13:33:21.000Z",
"updatedAt": "2026-07-03T11:19:31.000Z",
"orderNote": "order notes value",
"totalLineItemPrice": 157.99,
"totalLineItemDiscountedPrice": 153.99,
"deliveryPrice": 0,
"currencyCode": "USD",
"status": "ACTIVE",
"cancellationReason": null,
"cancellationComment": null,
"completedOrdersCount": 1,
"pausedAt": null,
"cancelledAt": null,
"attributes": [
{
"key": "New key",
"value": "New key value"
}
],
"isPrepaid": false,
"isMarkedForCancellation": false,
"nextBillingDateEpoch": 1788035700,
"chargeOffset": 4,
"lastPaymentStatus": "SUCCESS",
"lastInventoryAction": null,
"deliveryMethod": {
"code": "SHIPPING",
"title": "SHIPPING"
},
"billingPolicy": {
"maxCycles": 13,
"minCycles": 3,
"interval": "MONTH",
"intervalCount": 1,
"anchorDay": 3,
"anchorMonth": null,
"anchorType": "MONTHDAY"
},
"deliveryPolicy": {
"interval": "MONTH",
"intervalCount": 1
},
"shippingAddress": {
"firstName": "Trew",
"lastName": "Max",
"phone": null,
"company": null,
"address1": "HOME 123 Street 2",
"address2": null,
"city": "Marietta",
"zip": "30060",
"countryCode": "US",
"provinceCode": "GA"
},
"lines": [
{
"id": 77883315,
"productShopifyId": 8932887462042,
"variantShopifyId": 48502495445146,
"sellingPlanShopifyId": 305659674778,
"sellingPlanName": "Deliver every month",
"sellingPlanGroupName": "N Subscribe and Save",
"sellingPlanGroupMerchantCode": "N Subscribe and Save",
"variantTitle": "Floral",
"productTitle": "Clear skin cream",
"name": "Clear skin cream - Floral",
"price": "140.00",
"basePrice": 150,
"discountedPrice": 136.46,
"quantity": 1,
"sku": null,
"isOneTimeAdded": false,
"isOneTimeRemoved": false,
"bundleTransactionId": null,
"loopBundleId": null,
"attributes": [
{
"key": "Line item key",
"value": "Value"
}
],
"weightInGrams": 0,
"discounts": [
{
"shopifyId": "83bbf31c-ad15-41e4-b5f7-3880669b3d7e",
"title": "FLOW Subscription discount",
"isActive": true,
"type": "MANUAL",
"value": {
"amount": {
"amount": "4.0",
"currencyCode": "USD"
},
"appliesOnEachItem": false
},
"orderLimit": 1,
"usageCount": 0
}
],
"variantImage": "https://cdn.shopify.com/s/files/1/0676/9973/6730/files/skinscream.webp?v=1778828304"
},
{
"id": 78030884,
"productShopifyId": 9010427691162,
"variantShopifyId": 48528740319386,
"sellingPlanShopifyId": 305659674778,
"sellingPlanName": "Deliver every month",
"sellingPlanGroupName": "N Subscribe and Save",
"sellingPlanGroupMerchantCode": "N Subscribe and Save",
"variantTitle": "2",
"productTitle": "260 Variant Product",
"name": "260 Variant Product - 2",
"price": "17.99",
"basePrice": 19.99,
"discountedPrice": 17.53,
"quantity": 1,
"sku": "VAR-2",
"isOneTimeAdded": true,
"isOneTimeRemoved": false,
"bundleTransactionId": null,
"loopBundleId": null,
"attributes": [
{
"key": "is_one_time",
"value": "true"
},
{
"key": "_loopUpsellId",
"value": "01KWKV7XSM32BN8NPXP7JHGVKX"
}
],
"weightInGrams": 0,
"discounts": [
{
"shopifyId": "83bbf31c-ad15-41e4-b5f7-3880669b3d7e",
"title": "FLOW Subscription discount",
"isActive": true,
"type": "MANUAL",
"value": {
"amount": {
"amount": "4.0",
"currencyCode": "USD"
},
"appliesOnEachItem": false
},
"orderLimit": 1,
"usageCount": 0
}
],
"variantImage": "https://cdn.shopify.com/s/files/1/0676/9973/6730/files/Shipiconsave_93fbd69a-e259-45bd-b154-35645512b76d.png?v=1782739917"
}
],
"customer": {
"id": 591628030,
"shopifyId": 9205248393370,
"email": "[email protected]"
},
"discounts": [
{
"shopifyId": "83bbf31c-ad15-41e4-b5f7-3880669b3d7e",
"title": "FLOW Subscription discount",
"isActive": true,
"type": "MANUAL",
"value": {
"amount": {
"amount": "4.0",
"currencyCode": "USD"
},
"__typename": "SubscriptionDiscountFixedAmountValue",
"appliesOnEachItem": false
},
"isEntitledAllLines": true,
"orderLimit": 1,
"usageCount": 0,
"targetType": "LINE_ITEM"
}
],
"prepaidCredits": null,
"customerPaymentMethodId": 32472524,
"billingAddress": {
"zip": "30060",
"city": "Marietta",
"country": "US",
"address1": "HOME 123 Street 2",
"province": "GA",
"countryCode": "US",
"provinceCode": "GA"
},
"isMigrated": false,
"paymentMethod": {
"id": 32472524,
"type": "CustomerCreditCard",
"card": {
"brand": "visa",
"expiryYear": 45,
"expiryMonth": 12,
"lastDigits": "4242"
},
"payPal": null,
"status": "safe",
"source": "Credit card (Primary gateway)"
},
"backupPaymentMethod": {
"id": 32558164,
"type": "CustomerCreditCard",
"card": {
"brand": "visa",
"expiryYear": 71,
"expiryMonth": 12,
"lastDigits": "4242"
},
"payPal": null,
"status": "safe",
"source": "Credit card (Primary gateway)"
}
},
"code": "SUCCESS",
"pageInfo": null
}