Read subscription by Shopify ID

Fetch all important details of a specific subscription using Shopify ID. Rate limit: 10/ sec

Subscription Object Fields

FieldDescription
subscription_shopify_idShopify id of the subscription contract.
customer_shopify_idShopify id of the customer associated with the subscription.
customerCustomer object with details such as "customer_shopify_id", "first_name", "last_name", "email".
created_atDate time when the subscription was created.
updated_atDate time when the subscription was updated.
total_line_item_priceTotal price of all the subscription line items not including taxes & discounts.
total_line_item_discounted_priceTotal price of all the subscription line items including discounts.
delivery_priceShipping charges associated with the delivery.
currency_codeCurrency code for all the prices.
statusStatus of the subscription as on Shopify.
billing_attempt_success_countNumber of successful billing attempts or in other words the total number of orders created for a subscription including the first order.
paused_atDate time when the subscription was paused.
cancelled_atDate time when the subscription was cancelled.
cancellation_reasonReason selected by the customer for cancelling subscription.
cancellation_commentRemarks provided by the customer for cancelling subscription.
is_prepaidBoolean value specifying if the subscription is prepaid or not.
next_billing_dateDate time of the next upcoming charge for the subscription.
charge_offset_daysUseful for scheduling orders based on delivery dates. Delivery date = next_billing_date + charge_offset_days.
billing_intervalBilling interval type (DAY, WEEK, MONTH, YEAR).
billing_interval_countBilling interval value.
billing_min_cyclesNumber of minimum payments before which the subscription cannot be cancelled. Initial order is counted towards the limit.
billing_max_cyclesNumber of maximum billings after which the subscription will auto-expire. Initial order is counted towards the limit.
billing_anchor_typeAnchor type (WEEK, MONTH, YEAR)
billing_anchor_dayAnchor day value (1-7 for WEEK, 1-31 for MONTH & YEAR anchor type).
billing_anchor_monthAnchor month value (1-12 for YEAR anchor type).
delivery_intervalDelivery interval type (DAY, WEEK, MONTH, YEAR).
delivery_interval_countDelivery interval value.
line_itemsLine item object having fields related to products added in subscription. Described in the table below.
shipping_addressShipping address object having fields like "first_name", "last_name", "phone", "company", "address1", "address2", "city", "zip", "country", "province", "province_code", "country_code"
noteNote or special instructions which are stored on subscription and passed on for every recurring order placed on the subscription.
custom_attributesAppears in the Additional details section of an order details page. Each array entry must contain a hash with name and value keys.
will_auto_resumeBoolean value specifying if a paused subscription will auto-resume or not after the paused duration is over.
shipping_lines_titleShipping method title.
shipping_lines_codeShipping method code which is used by 3rd party fulfillment apps to map the courier services.
has_custom_planBoolean value specifying if the subscription is offering a custom frequency which is not part of the standard subscription plans.
has_bundleBoolean value specifying if the subscription has bundle items.

Line Items Object Fields

FieldDescription
line_shopify_idShopify id for the line.
product_shopify_idShopify id for the product associated with the line.
variant_shopify_idShopify id for the variant associated with the line.
product_titleTitle of the product associated with the line.
variant_titleTitle of the variant associated with the line.
nameName of the line combining product_title and variant_title
variant_imageURL for the image associated with the product.
requires_shippingSpecifies whether the product requires shipping or not.
taxableSpecifies whether the product is taxable or not.
currency_codeCurrency code associated with the prices on the line.
priceSubscription price for the product variant associated with the line.
base_priceBase price for the product variant associated with the line. Subscription discounts are applied on this price.
discounted_priceFinal discounted price for the product variant charged to the customer after applying discounts.
discount_allocationsDiscount allocations on the line. It doesn't include discounts applied as part of subscription.
quantityQuantity for the product variant associated with the line.
pricing_policyPricing policy for the product variant associated with the line. It includes the subscription discount info.
selling_plan_idShopify subscription plan id through which the line was created.
selling_plan_nameName of the subscription plan associated with the line.
skuSKU associated with the product of the line.
is_one_time_addedSpecifies whether the product is added only for the upcoming order or not.
is_one_time_removedSpecifies whether the product is removed only for the upcoming order or not.
bundle_transaction_idUnique ID to identify and group the bundle items together
bundle_nameName of the bundle the line item belongs to
created_atDate time when the line item was created.
updated_atDate time when the line item was updated.
Language
Authorization
Header
Click Try It! to start a request and see the response here!