---
title: "GET /orders/{orderId}/substitute/{OrderItemLineId}"
method: GET
path: "/orders/{orderId}/substitute/{OrderItemLineId}"
tags: ["Order amendments"]
---

# GET /orders/{orderId}/substitute/{OrderItemLineId}

`GET /orders/{orderId}/substitute/{OrderItemLineId}`

Grubtech will retrieve eligible substitutions for an item if the aggregator platform supports this feature.

## Path parameters

- `orderId` string, required
- `OrderItemLineId` string, required

## Query parameters

- `needle` integer, required
- `limit` integer, required
- `quantity` integer, required

## Response `200`

Successful response

- SubstitutionItems[] — List of possible substitutions
  - `lineId` string — Unique identifier for each substitution suggestion
  - `id` string, required — Item identifier of the substitution item.
  - `sku` string — Stock keeping unit ID for the menu item, provided by GrubTech.
  - `name` MultiLingualText — Content for a string displayed to users in multiple languages <br/> Supported laguages (Locale ids) <br/> * en-us :- English (United States) <br/> * ar-ae :- Arabic (United Arab Emirates)
    - `translations` Translations, required — A mapping from locale code to the translated text in each locale. One translation must be provided. e.g. "en-us", "ar-ae"
  - `quantity` integer, required — Quantity of items that can be used for substitution.
  - `unitPrice` integer, required — Specifies the unit price to charge for ordering the item. Price should always be an integer value (never decimals) because the price is set in the lowest denomination (e.g., cents for US currency, not dollars). Price should always be set even if the price is 0.

## Other responses

- `400` — Bad request
- `500` — Internal server error

---

[API](https://skmtc.net/grubtech/apis/grubtech-auth-server.md) · [All operations](https://skmtc.net/grubtech/apis/grubtech-auth-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/grubtech/grubtech-auth-server/revisions/21688b6dcb69/schema)