grubhub · JSON Structure

Grubhub Orderstatuswebhookpayload Structure

Webhook payload for an order status change event.

Type: object Properties: 6

Grubhub Order Status Webhook Payload is a JSON Structure definition published by grubhub, describing 6 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

event_type order_uuid merchant_id previous_status new_status updated_at

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑ 
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/grubhub/refs/heads/main/json-structure/grubhub-orderstatuswebhookpayload-structure.json",
  "name": "Grubhub Order Status Webhook Payload",
  "description": "Webhook payload for an order status change event.",
  "type": "object",
  "properties": {
    "event_type": {
      "type": "string",
      "description": "The type of event that triggered this webhook.",
      "const": "ORDER_STATUS_CHANGE",
      "example": "STANDARD"
    },
    "order_uuid": {
      "type": "uuid",
      "description": "The unique identifier for the order.",
      "example": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    },
    "merchant_id": {
      "type": "string",
      "description": "The Grubhub merchant identifier.",
      "example": "ghm-1234567890"
    },
    "previous_status": {
      "type": "string",
      "description": "The previous order status.",
      "example": "ACTIVE"
    },
    "new_status": {
      "type": "string",
      "description": "The new order status.",
      "enum": [
        "CONFIRMED",
        "IN_PROGRESS",
        "READY",
        "OUT_FOR_DELIVERY",
        "COMPLETED"
      ],
      "example": "CONFIRMED"
    },
    "updated_at": {
      "type": "datetime",
      "description": "When the status was updated.",
      "example": "2026-06-02T18:30:00Z"
    }
  }
}