Subscription

orderStatusChanged

Subscribes to real-time order status updates for a specific order. Emits an event whenever the order status changes, including the new status, previous status, and timestamp.

Tags: orders, realtime, status

Signature

subscription { orderStatusChanged(orderId: ID!): OrderStatusChangedEvent! }

Arguments

Name	Type	Required	Description
`orderId`	`ID!`	Yes	The unique identifier of the order to monitor

Return Type

OrderStatusChangedEvent!

Complexity: 2

Examples

Query

subscription OnOrderStatusChanged($orderId: ID!) {
  orderStatusChanged(orderId: $orderId) {
    order {
      id
      status
      updatedAt
    }
    previousStatus
    newStatus
    changedAt
    note
  }
}

Variables

{
  "orderId": "order_abc123"
}

Response

{
  "data": {
    "orderStatusChanged": {
      "order": {
        "id": "order_abc123",
        "status": "SHIPPED",
        "updatedAt": "2024-06-21T09:30:00Z"
      },
      "previousStatus": "CONFIRMED",
      "newStatus": "SHIPPED",
      "changedAt": "2024-06-21T09:30:00Z",
      "note": "Dispatched via express courier"
    }
  }
}