--- title: "Get Order History By ID" method: GET path: "/orders/{orderId}" --- # Get Order History By ID `GET /orders/{orderId}` ## Request - Base URL: `https://api.staging.grubtech.io/order-api` - URL: `https://api.staging.grubtech.io/order-api/orders/{orderId}` - Auth: API key in header `X-API-KEY` The **Get Order History By ID** endpoint in the API provides an efficient method for accessing order records, status, and other specific data associated with individual orders. ## Path parameters - `orderId` string, required ## Response `200` Successful response with the requested order. - Order - `id` string: A unique identifier representing an order on the order platform. - `displayId` string: Human-readable short order ID, to be used by stores and couriers to identify the order. - `sequenceNo` string - `brand` Brand: Brand details of the partner related to a specific order. - `id` string: Unique identifier to represent the brand in Grubtech - `name` string: Name of the brand - `kitchen` Kitchen: Kitchen details of the partner related to a specific order. - `id` string: Unique identifier to represent kitchen in Grubtech - `name` string: Name of the kitchen - `type` string: Type of an order. Indicates how the order will be served to the customer. Possible values are DELIVERY_BY_FOOD_AGGREGATOR, DELIVERY_BY_RESTAURANT, DINE_IN and PICK_UP - `instructions` string: Instructions from a customer regarding the order preparation. - `delivery` Delivery: Contains delivery details for the order. If delivery is from GrubTech end, this field should not be null and must include all necessary information related to the delivery. - `receiverName` string: Name of the receiver - `receiverMobileNumber` string: Mobile number of the receiver - `location` Location: The precise address where the order will be received. - `address` string: Complete address of the location - `latitude` string: Geographic coordinate that specifies the north-south position of a point on the Earth's surface. - `longitude` string: Geographic coordinate that specifies the east-west position of a point on the Earth's surface. - `notes` string: A special note for delivery - `customer` Customer: The details of the person who is placing the order. - `name` string: Name of the customer - `contactNumber` string: Contact number of the customer - `email` string: Email address of the customer - `items` Item[] - `id` string: Unique identifying string for the item provided by the store. - `internalItemId` string: Unique identifier for the item on the Grubtech platform, consistent across all stores. - `name` string: Name of the item - `quantity` integer: Quantity of the items - `price` Price: Pricing information of the order which contains the unit price, taxes, discounts, and total price - `unitPrice` Money: Detailed information of the price with the amount, currency, and formatted amount. - `amount` integer: Specify the price amount as an integer, representing the lowest denomination (e.g., cents for USD rather than dollars). The price must always be provided, even if it is 0. - `currencyCode` string: Three-letter alphabetic codes represent the various currencies used worldwide. - `formattedAmount` string: Formatted amount. A display-friendly formatted string representation of the price amount, including currency code. - `discountAmount` Money: Detailed information of the price with the amount, currency, and formatted amount. - `amount` integer: Specify the price amount as an integer, representing the lowest denomination (e.g., cents for USD rather than dollars). The price must always be provided, even if it is 0. - `currencyCode` string: Three-letter alphabetic codes represent the various currencies used worldwide. - `formattedAmount` string: Formatted amount. A display-friendly formatted string representation of the price amount, including currency code. - `taxAmount` Money: Detailed information of the price with the amount, currency, and formatted amount. - `amount` integer: Specify the price amount as an integer, representing the lowest denomination (e.g., cents for USD rather than dollars). The price must always be provided, even if it is 0. - `currencyCode` string: Three-letter alphabetic codes represent the various currencies used worldwide. - `formattedAmount` string: Formatted amount. A display-friendly formatted string representation of the price amount, including currency code. - `totalPrice` Money: Detailed information of the price with the amount, currency, and formatted amount. - `amount` integer: Specify the price amount as an integer, representing the lowest denomination (e.g., cents for USD rather than dollars). The price must always be provided, even if it is 0. - `currencyCode` string: Three-letter alphabetic codes represent the various currencies used worldwide. - `formattedAmount` string: Formatted amount. A display-friendly formatted string representation of the price amount, including currency code. - `modifiers` Modifier[] - `id` string: Internal reference of the modifier, provided through the menu - `internalModifierId` string: Unique identifer for the modifier on Grubtech platform that distinguishes it across all stores. - `name` string: Name of the modifier - `quantity` integer: number of modifiers - `price` Price: Pricing information of the order which contains the unit price, taxes, discounts, and total price - `unitPrice` Money: Detailed information of the price with the amount, currency, and formatted amount. - `amount` integer: Specify the price amount as an integer, representing the lowest denomination (e.g., cents for USD rather than dollars). The price must always be provided, even if it is 0. - `currencyCode` string: Three-letter alphabetic codes represent the various currencies used worldwide. - `formattedAmount` string: Formatted amount. A display-friendly formatted string representation of the price amount, including currency code. - `discountAmount` Money: Detailed information of the price with the amount, currency, and formatted amount. - `amount` integer: Specify the price amount as an integer, representing the lowest denomination (e.g., cents for USD rather than dollars). The price must always be provided, even if it is 0. - `currencyCode` string: Three-letter alphabetic codes represent the various currencies used worldwide. - `formattedAmount` string: Formatted amount. A display-friendly formatted string representation of the price amount, including currency code. - `taxAmount` Money: Detailed information of the price with the amount, currency, and formatted amount. - `amount` integer: Specify the price amount as an integer, representing the lowest denomination (e.g., cents for USD rather than dollars). The price must always be provided, even if it is 0. - `currencyCode` string: Three-letter alphabetic codes represent the various currencies used worldwide. - `formattedAmount` string: Formatted amount. A display-friendly formatted string representation of the price amount, including currency code. - `totalPrice` Money: Detailed information of the price with the amount, currency, and formatted amount. - `amount` integer: Specify the price amount as an integer, representing the lowest denomination (e.g., cents for USD rather than dollars). The price must always be provided, even if it is 0. - `currencyCode` string: Three-letter alphabetic codes represent the various currencies used worldwide. - `formattedAmount` string: Formatted amount. A display-friendly formatted string representation of the price amount, including currency code. - `payment` Payment: Payment information related to an order - `status` 'PREPAID' | 'POSTPAID' | 'UNPAID' | 'FOC': The payment status of an order indicates whether the payment has been made in advance or upon delivery. PREPAID is used when the payment is completed upfront, such as when a credit card is used at the time the order is placed. UNPAID is used when payment is made upon delivery, such as cash on delivery or card on delivery. - `method` 'CASH' | 'CARD' | 'PREPAID' | 'FOC' | 'LOYALTY_POINTS' | 'VOUCHER' | 'MIXED': The payment method associated with an order, which should be used alongside the payment status. For example, if the payment method is Cash on Delivery, the payment status should be UNPAID, and the payment method should be marked as CASH. - `charges` Charges: The various charges that make up the total payment for an order, primarily related to the cost of transporting goods from the seller to the buyer. - `subTotal` Money: Detailed information of the price with the amount, currency, and formatted amount. - `amount` integer: Specify the price amount as an integer, representing the lowest denomination (e.g., cents for USD rather than dollars). The price must always be provided, even if it is 0. - `currencyCode` string: Three-letter alphabetic codes represent the various currencies used worldwide. - `formattedAmount` string: Formatted amount. A display-friendly formatted string representation of the price amount, including currency code. - `total` Money: Detailed information of the price with the amount, currency, and formatted amount. - `amount` integer: Specify the price amount as an integer, representing the lowest denomination (e.g., cents for USD rather than dollars). The price must always be provided, even if it is 0. - `currencyCode` string: Three-letter alphabetic codes represent the various currencies used worldwide. - `formattedAmount` string: Formatted amount. A display-friendly formatted string representation of the price amount, including currency code. - `deliveryFee` Money: Detailed information of the price with the amount, currency, and formatted amount. - `amount` integer: Specify the price amount as an integer, representing the lowest denomination (e.g., cents for USD rather than dollars). The price must always be provided, even if it is 0. - `currencyCode` string: Three-letter alphabetic codes represent the various currencies used worldwide. - `formattedAmount` string: Formatted amount. A display-friendly formatted string representation of the price amount, including currency code. - `additionalCharges` AdditionalCharges[] - `type` 'SERVICE_FEE' | 'DELIVERY_FEE' | 'DELIVERY_TIPS' | 'WAITER_TIPS' | 'SURCHARGE' | 'OTHER_FEES' | 'PACKAGING_FEE' | 'ENVIRONMENTAL_FEE': Service Types - `price` Price: Pricing information of the order which contains the unit price, taxes, discounts, and total price - `unitPrice` Money: Detailed information of the price with the amount, currency, and formatted amount. - `amount` integer: Specify the price amount as an integer, representing the lowest denomination (e.g., cents for USD rather than dollars). The price must always be provided, even if it is 0. - `currencyCode` string: Three-letter alphabetic codes represent the various currencies used worldwide. - `formattedAmount` string: Formatted amount. A display-friendly formatted string representation of the price amount, including currency code. - `discountAmount` Money: Detailed information of the price with the amount, currency, and formatted amount. - `amount` integer: Specify the price amount as an integer, representing the lowest denomination (e.g., cents for USD rather than dollars). The price must always be provided, even if it is 0. - `currencyCode` string: Three-letter alphabetic codes represent the various currencies used worldwide. - `formattedAmount` string: Formatted amount. A display-friendly formatted string representation of the price amount, including currency code. - `taxAmount` Money: Detailed information of the price with the amount, currency, and formatted amount. - `amount` integer: Specify the price amount as an integer, representing the lowest denomination (e.g., cents for USD rather than dollars). The price must always be provided, even if it is 0. - `currencyCode` string: Three-letter alphabetic codes represent the various currencies used worldwide. - `formattedAmount` string: Formatted amount. A display-friendly formatted string representation of the price amount, including currency code. - `totalPrice` Money: Detailed information of the price with the amount, currency, and formatted amount. - `amount` integer: Specify the price amount as an integer, representing the lowest denomination (e.g., cents for USD rather than dollars). The price must always be provided, even if it is 0. - `currencyCode` string: Three-letter alphabetic codes represent the various currencies used worldwide. - `formattedAmount` string: Formatted amount. A display-friendly formatted string representation of the price amount, including currency code. - `tax` Tax[] - `amount` Money: Detailed information of the price with the amount, currency, and formatted amount. - `amount` integer: Specify the price amount as an integer, representing the lowest denomination (e.g., cents for USD rather than dollars). The price must always be provided, even if it is 0. - `currencyCode` string: Three-letter alphabetic codes represent the various currencies used worldwide. - `formattedAmount` string: Formatted amount. A display-friendly formatted string representation of the price amount, including currency code. - `name` string: the display name of the tax type. Ex:- VAT - `discounts` Discount[] - `amount` Money: Detailed information of the price with the amount, currency, and formatted amount. - `amount` integer: Specify the price amount as an integer, representing the lowest denomination (e.g., cents for USD rather than dollars). The price must always be provided, even if it is 0. - `currencyCode` string: Three-letter alphabetic codes represent the various currencies used worldwide. - `formattedAmount` string: Formatted amount. A display-friendly formatted string representation of the price amount, including currency code. - `code` string: Code to identify the specific occasion or season - `type` 'PROMOTION' | 'VOUCHER': Discount type - `tax` Tax[] - `amount` Money: Detailed information of the price with the amount, currency, and formatted amount. - `amount` integer: Specify the price amount as an integer, representing the lowest denomination (e.g., cents for USD rather than dollars). The price must always be provided, even if it is 0. - `currencyCode` string: Three-letter alphabetic codes represent the various currencies used worldwide. - `formattedAmount` string: Formatted amount. A display-friendly formatted string representation of the price amount, including currency code. - `name` string: the display name of the tax type. Ex:- VAT - `settlements` PaymentSettlement[] - `method` 'CASH' | 'CARD' | 'PREPAID' | 'LOYALTY_POINTS' | 'VOUCHER' | 'FOC', required: Payment method of the payment settlement - `amount` Money, required: Detailed information of the price with the amount, currency, and formatted amount. - `amount` integer: Specify the price amount as an integer, representing the lowest denomination (e.g., cents for USD rather than dollars). The price must always be provided, even if it is 0. - `currencyCode` string: Three-letter alphabetic codes represent the various currencies used worldwide. - `formattedAmount` string: Formatted amount. A display-friendly formatted string representation of the price amount, including currency code. - `notes` string: Remarks regarding the settlement - `source` Source: Detailed information about the order source - `name` string: Specifies the order source name - `uniqueOrderId` string: Unique identifier representing an order on the order platform - `placedAt` string: The time that the particular order was placed, represented in ISO8601 format. - `channel` string: Specifies the order channel - `status` string: Order status which indicates the status of the order. - `placedAt` string: The time the order was placed, represented in ISO 8601 format. - `scheduledOrder` boolean: Indicates whether this order is scheduled or not. ## Other responses - `400`: Error response when the server could not understand the request due to an invalid syntax or structure. - `500`: A generic error response that indicates a problem with the web server. --- [API](https://skmtc.dev/grubtech/apis/grubtech-data-api.md) - [All operations](https://skmtc.dev/grubtech/apis/grubtech-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/grubtech/apis/grubtech-data-api/revisions/ee65d77a109c?raw)