{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/grubhub/main/json-schema/grubhub-lineoption-schema.json",
  "title": "LineOption",
  "x-generated": "2026-09-17",
  "x-method": "derived",
  "x-source": "openapi/grubhub-orders-openapi.yml#/components/schemas/LineOption",
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "description": "DEPRECATED. A label for this line item option."
    },
    "price": {
      "type": "integer",
      "description": "The price of this item in US Cents.",
      "format": "int32"
    },
    "id": {
      "type": "string",
      "description": "A Grubhub id (legacy_id) for this option."
    },
    "uuid": {
      "type": "string",
      "description": "Unique line option id for this order instance.",
      "format": "uuid"
    },
    "name": {
      "type": "string",
      "description": "The name of this option."
    },
    "line_sub_options": {
      "type": "array",
      "description": "Sub-options applied to this option.",
      "items": {
        "$ref": "#/$defs/LineSubOption"
      }
    },
    "external_id": {
      "type": "string",
      "description": "The external ID that was stored in Grubhub for this option."
    },
    "metadata": {
      "type": "string",
      "description": "Metadata associated with the line option."
    },
    "quantity": {
      "type": "integer",
      "description": "The number of this line options to include.",
      "format": "int32"
    },
    "routing_tags": {
      "uniqueItems": true,
      "type": "array",
      "description": "Used to route where a line option is printed and/or displayed.",
      "items": {
        "type": "string",
        "description": "Used to route where a line option is printed and/or displayed."
      }
    },
    "default_context": {
      "$ref": "#/$defs/DefaultContext"
    }
  },
  "description": "Options applied to a Line Item",
  "$defs": {
    "DefaultContext": {
      "type": "object",
      "properties": {
        "removed": {
          "type": "boolean",
          "description": "True if boolean line or line sub option has been removed"
        },
        "default_quantity": {
          "type": "integer",
          "description": "Present for line or line sub option with quantity if NormalizedModifierPrompt.modifier_prompt_quantity_settings",
          "format": "int64"
        },
        "unit_price": {
          "type": "integer",
          "description": "Present for line or line sub option with default_quantity, quantity_free, and selected quantity is greater than quantity_free",
          "format": "int64"
        }
      },
      "description": "Contextual information to compare a line or line sub option to its default state"
    },
    "LineSubOption": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The Grubhub ID of the sub option."
        },
        "name": {
          "type": "string",
          "description": "The name of the sub option, which will be shown to diners."
        },
        "price": {
          "type": "integer",
          "description": "Deprecated. Use "merchant_price" instead.",
          "format": "int32",
          "deprecated": true
        },
        "merchant_price": {
          "type": "integer",
          "description": "The price of this item in US Cents.",
          "format": "int64"
        },
        "diner_price": {
          "type": "integer",
          "description": "Cost to diner, in cents.",
          "format": "int64"
        },
        "choice_category_id": {
          "type": "string",
          "description": "The category Id the choice belongs to."
        },
        "quantity": {
          "type": "integer",
          "description": "The amount of this option to add to the previous option. This can indicate combos (single menu items with multiple selectable items), options with variable amounts, or options that can be selected multiple times.",
          "format": "int32"
        },
        "tags": {
          "type": "array",
          "description": "Grubhub tag IDs that apply to this line item.",
          "items": {
            "$ref": "#/$defs/LineTag"
          }
        },
        "line_sub_options": {
          "type": "array",
          "description": "Further sub options that apply to this sub option. These can be nested up to ten levels deep.",
          "items": {
            "$ref": "#/$defs/LineSubOption"
          }
        },
        "external_id": {
          "type": "string",
          "description": "The external ID that was stored in Grubhub for this menu suboption."
        },
        "metadata": {
          "type": "string",
          "description": "Metadata associated with the line option."
        },
        "routing_tags": {
          "uniqueItems": true,
          "type": "array",
          "description": "Used to route where a line option is printed and/or displayed.",
          "items": {
            "type": "string",
            "description": "Used to route where a line option is printed and/or displayed."
          }
        },
        "default_context": {
          "$ref": "#/$defs/DefaultContext"
        }
      },
      "description": "Sub Options that are applied to an Option or other Sub Option. These can be nested up to ten levels deep."
    },
    "LineTag": {
      "type": "object",
      "properties": {
        "ghc_tag_id": {
          "type": "integer",
          "description": "The Grubhub Id for the tag.",
          "format": "int64"
        },
        "name": {
          "type": "string",
          "description": "The name of the tag."
        }
      },
      "description": "Tags that are associated with line items."
    }
  }
}