MenuQL
MenuQL is PAR Ordering's proprietary query language. It lets you choose which attributes and relations come back on a response, and apply sorting, filtering and pagination.
MenuQL is legacy, and it does not apply to the menu. Menu v2 does not support any of it — build your menu against the Menu v2 endpoints and their documented responses. This page exists for the two remaining Ordering API operations that still take a required include:
GET /venues/{venue_id}GET /discounts/{discount_id}/venues/{venue_id}/menus/{menu_id}/discount-groups
Both require the X-QL-Enabled: true header. It is what activates the query builder; without it the parameters below are ignored and you get the endpoint's default payload. Do not send that header on any other operation.
The attribute and relation names in the examples below are those of the legacy menu entities. They illustrate the syntax — use the names each operation documents, not these.
Query Builder
Available query parameters
| Parameter | Value | Repeatable | Description |
|---|---|---|---|
| page | integer | FALSE | The page to return. Defaults to 1; a page past the end falls back to the default. Example: page=2 |
| per_page | integer | FALSE | Items per page. Defaults to 20. Example: per_page=10 |
| paginated_results | boolean | FALSE | false turns pagination off on a list call and returns every item. Defaults to true. Ignored on calls that fetch a single item by id, which are never paginated |
| include | string array |
FALSE | Which attributes and relations to return. Separate several with commas (include=introduction,translations,name). Name a relation to nest it (include=subcategories), use . to reach into it (subcategories.image), and | plus ; to pick a relation's attributes (core_items|state;name). Without it you get the entity's id only. Each operation documents which names it accepts. Example: include=translations,subcategories.image,image returns translations on the top-level entity, nests subcategories, and returns image on both levels |
| sort[attribute_name] | string | TRUE | Sort by an attribute, asc or desc. To sort inside an included relation, prefix the attribute with the relation name and a dot. Examples: sort[id]=asc sorts the top-level entities; sort[core_items.name]=asc sorts the included core_items |
| filter[attribute_name] | boolean integer string array |
TRUE | Keep only entities whose attribute matches the value — a boolean, a number, a string, or a comma-separated list that matches any of its entries (filter[code]=ec1,ec2). Prefix with a relation name and a dot to filter on a relation. Example: filter[is_visible]=true |
