> ## Documentation Index
> Fetch the complete documentation index at: https://developers.appstle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get the live fulfillment status for an order



## OpenAPI

````yaml /subscription/storefront-api-swagger.json get /subscriptions/cp/api/orders/{orderId}/live-status
openapi: 3.0.1
info:
  description: >-
    Comprehensive API documentation for the customer-facing subscription portal.
    These APIs enable customers to manage their subscriptions, update billing
    information, modify delivery schedules, and access their account details
    through your storefront.


    **Important**: These APIs must be called from your shop's domain (e.g.,
    https://www.myshop.com/apps/subscriptions/cp/api/**) and require customer
    authentication. Unauthenticated requests will return a 401 Unauthorized
    error.
  title: Storefront APIs
  version: 0.0.1
servers:
  - url: https://www.myshop.com/apps
security: []
tags:
  - description: >-
      Core customer portal APIs for managing customer account settings,
      authentication, and portal configurations.
    name: Customer Portal
  - description: >-
      APIs for customers to view and manage their subscription contracts
      including status updates, frequency changes, and cancellations.
    name: Subscription Management
  - description: >-
      APIs for retrieving and updating subscription contract details — delivery
      schedules, line items, addresses, billing cycles.
    name: Subscription Contracts
  - description: >-
      APIs for retrieving available subscription plans and selling plan
      configurations exposed to customers.
    name: Subscription Plans
  - description: >-
      APIs for managing one-time add-on products that can be purchased alongside
      recurring subscription items.
    name: Subscription One-Time Products
  - description: >-
      APIs for retrieving aggregated subscription data and account-level
      subscription information for the signed-in customer.
    name: Subscription Data
  - description: >-
      APIs for managing customizable product boxes and bundles where customers
      can select multiple items.
    name: Build-a-Box & Bundles
  - description: >-
      APIs for managing payment methods, billing information, and processing
      subscription payments.
    name: Billing & Payments
  - description: >-
      APIs for retrieving product information, selling plans, variant data, and
      subscription-enabled products available to customers.
    name: Product Catalog
  - description: >-
      APIs for managing delivery schedules, shipping addresses, delivery
      methods, and tracking order status.
    name: Delivery & Shipping
  - description: >-
      APIs for handling subscription cancellations, retention activities, and
      customer feedback management.
    name: Customer Retention
  - description: >-
      APIs for integrating loyalty programs with subscriptions including points
      redemption and earning options.
    name: Loyalty Integration
  - description: >-
      APIs for accessing portal customization settings, translations, and theme
      configurations.
    name: Customization
  - description: >-
      APIs for retrieving promotional campaigns shown in the customer portal,
      tracking banner engagement, and redeeming campaign offers.
    name: Campaigns
  - description: >-
      APIs for local pickup and click-and-collect — listing pickup locations and
      resolving eligible pickup dates and time slots.
    name: Store Pickup
paths:
  /subscriptions/cp/api/orders/{orderId}/live-status:
    get:
      tags:
        - Delivery & Shipping
      summary: Get the live fulfillment status for an order
      operationId: getOrderLiveStatus
      parameters:
        - in: path
          name: orderId
          required: true
          schema:
            format: int64
            type: integer
      responses:
        '200':
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/OrderLiveStatusDTO'
          description: OK
components:
  schemas:
    OrderLiveStatusDTO:
      properties:
        currencyCode:
          type: string
        currentSubtotalPrice:
          type: string
        currentTotalPrice:
          type: string
        events:
          items:
            $ref: '#/components/schemas/OrderEventDTO'
          type: array
        eventsEndCursor:
          type: string
        eventsHasNextPage:
          type: boolean
        graphOrderId:
          type: string
        lineItems:
          items:
            $ref: '#/components/schemas/LineItemDTO'
          type: array
        orderCancelReason:
          enum:
            - CUSTOMER
            - DECLINED
            - FRAUD
            - INVENTORY
            - STAFF
            - OTHER
            - $UNKNOWN
          type: string
        orderCancelledAt:
          format: date-time
          type: string
        orderClosed:
          type: boolean
        orderClosedAt:
          format: date-time
          type: string
        orderConfirmed:
          type: boolean
        orderCreatedAt:
          format: date-time
          type: string
        orderDisplayFinancialStatus:
          enum:
            - PENDING
            - AUTHORIZED
            - PARTIALLY_PAID
            - PARTIALLY_REFUNDED
            - VOIDED
            - PAID
            - REFUNDED
            - EXPIRED
            - $UNKNOWN
          type: string
        orderDisplayFulfillmentStatus:
          enum:
            - UNFULFILLED
            - PARTIALLY_FULFILLED
            - FULFILLED
            - RESTOCKED
            - PENDING_FULFILLMENT
            - OPEN
            - IN_PROGRESS
            - ON_HOLD
            - SCHEDULED
            - REQUEST_DECLINED
            - $UNKNOWN
          type: string
        orderId:
          format: int64
          type: integer
        orderName:
          type: string
        orderProcessedAt:
          format: date-time
          type: string
        presentmentCurrencyCode:
          type: string
        presentmentCurrentSubtotalPrice:
          type: string
        presentmentCurrentTotalPrice:
          type: string
        presentmentSubtotalPrice:
          type: string
        presentmentTotalDiscount:
          type: string
        presentmentTotalPrice:
          type: string
        presentmentTotalReceived:
          type: string
        presentmentTotalRefunded:
          type: string
        presentmentTotalShipping:
          type: string
        presentmentTotalTax:
          type: string
        shippingAddress:
          $ref: '#/components/schemas/ShippingAddressDTO'
        shippingMethod:
          type: string
        subtotalPrice:
          type: string
        totalDiscount:
          type: string
        totalPrice:
          type: string
        totalReceived:
          type: string
        totalRefunded:
          type: string
        totalShipping:
          type: string
        totalTax:
          type: string
      type: object
    OrderEventDTO:
      properties:
        appTitle:
          type: string
        attributeToApp:
          type: boolean
        attributeToUser:
          type: boolean
        createdAt:
          format: date-time
          type: string
        id:
          type: string
        message:
          type: string
      type: object
    LineItemDTO:
      properties:
        currentQuantity:
          format: int32
          type: integer
        imageUrl:
          type: string
        originalPrice:
          type: string
        presentmentOriginalPrice:
          type: string
        presentmentPrice:
          type: string
        price:
          type: string
        productId:
          type: string
        quantity:
          format: int32
          type: integer
        title:
          type: string
        variantId:
          type: string
        variantTitle:
          type: string
      type: object
    ShippingAddressDTO:
      properties:
        address1:
          type: string
        address2:
          type: string
        city:
          type: string
        country:
          type: string
        firstName:
          type: string
        formatted:
          items:
            type: string
          type: array
        lastName:
          type: string
        province:
          type: string
        zip:
          type: string
      type: object

````