> ## Documentation Index
> Fetch the complete documentation index at: https://higginsgraferinc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve list of dishes in an order

> Retrieve the list of dishes included in an order along with the dish details. 

Each object in the array includes the individual properties of the dishes. The expeditor will use the `category`, `station`, and `preparation_time` values to prioritize dish preparation and send to the appropriate station displays. The station prep will use the list of ingredients during their preparation of the dsih.




## OpenAPI

````yaml openapi.yaml get /orders/{id}/dishes
openapi: 3.0.3
info:
  title: Point of Service (POS) API
  version: '1.0'
  description: >
    An example of a restaurant point of sale API, used to learn how to make API
    calls using Swagger, Github codespaces, and Postman, and to learn API
    documentation best practices.
  contact:
    name: Course Discord server
    url: https://discord.gg/dPsnz5u9
    email: mark.wentowski@docsgeek.io
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://reimagined-journey-g45xxv4v6gwhvrrr-80.app.github.dev
    description: The server URL used for the point of service API
    variables:
      gh-codespaces-server-url:
        default: https://reimagined-journey-g45xxv4v6gwhvrrr-80.app.github.dev
        description: >-
          Codespace URL used by Sarah Holdgrafer for Mastering API Documentation
          course.
  - url: http://localhost:80/
    description: Local URL for testing
security: []
tags:
  - name: Orders
    description: Methods for creating and managing orders in the client app.
  - name: Dishes
    description: Methods for creating and managing dishes in the client app.
  - name: Ingredients
    description: Methods used for creating and managing ingredients in the client app .
  - name: Users
    description: >-
      Methods for creating and managing the user accounts allowed to access the
      client app.
  - name: Auth
    description: Authentication endpoints for the client app (all methods use Basic auth).
paths:
  /orders/{id}/dishes:
    get:
      tags:
        - Orders
      summary: Retrieve list of dishes in an order
      description: >
        Retrieve the list of dishes included in an order along with the dish
        details. 


        Each object in the array includes the individual properties of the
        dishes. The expeditor will use the `category`, `station`, and
        `preparation_time` values to prioritize dish preparation and send to the
        appropriate station displays. The station prep will use the list of
        ingredients during their preparation of the dsih.
      operationId: getOrderDishes
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          example: 66294b2a4475a41f3e709bcb
          description: The unique dish identifier generated when the dish was created.
        - name: sort
          in: query
          description: >-
            Sort the list in the response by a specific property. Used with the
            `order` parameter.
          schema:
            type: string
          example: station
        - name: order
          in: query
          description: >-
            Set the sort order to `asc` for ascending or `desc` for descending.
            Must be used with the `sort` parameter.
          schema:
            type: string
          example: asc
        - name: fields
          in: query
          description: Restrict which properties are returned in the response.
          schema:
            type: string
          example: name|station|ingredients
        - name: filter
          in: query
          description: >-
            Filter the response to include only items that have properties equal
            to the specified value.
          schema:
            type: string
            example: created_at.gt~2024-05-07|station.eq~hot
        - name: limit
          in: query
          description: Limit the number of objects in the response.
          schema:
            type: integer
            maximum: 30
          example: 10
        - name: offset
          in: query
          description: Offsets the start of the list by the set value. Defaults to 0.
          schema:
            type: integer
            example: 0
      responses:
        '200':
          description: Request successful
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/Dish'
                  total_results:
                    type: integer
                    example: 1
        '400':
          description: Invalid request
        '401':
          description: Unauthorized
        '403':
          description: Access denied
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
components:
  schemas:
    Dish:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/Id'
        created_at:
          $ref: '#/components/schemas/CreatedAt'
        name:
          type: string
          example: Risotto alla Milanese
          description: The name of the dish that appears in the client app and for the KDS.
        description:
          $ref: '#/components/schemas/Description'
        category:
          $ref: '#/components/schemas/Category'
        image_name:
          $ref: '#/components/schemas/ImageName'
        ingredients:
          $ref: '#/components/schemas/Ingredients'
        preparation_time:
          $ref: '#/components/schemas/Price'
        price:
          $ref: '#/components/schemas/Price'
        station:
          $ref: '#/components/schemas/Station'
    Problem:
      type: object
      properties:
        title:
          type: string
          description: >-
            A short summary of the error or problem encountered with the
            request.
          example: Human-readable error title.
        detail:
          type: string
          description: >-
            A more detailed description of the error or problem to indicate the
            source and the solution, if possible.
          example: Human-readable error details.
      required:
        - title
        - detail
    Id:
      type: string
      example: 674d0bf5c28b69001f8e03a1
      readOnly: true
      description: >
        A unique alpha-numeric string generated by the system when creating a
        resource (e.g., dishes, ingredients, etc). Ids are required for
        retrieving the properties of a specific resource.
    CreatedAt:
      type: string
      format: date-time
      example: '2024-04-22T10:00:00Z'
      readOnly: true
      description: >
        The date and time the resource was created. Timestamp uses ISO 8601
        format, Ex: `2025-04-05T14:55:03.824Z` 
    Description:
      type: string
      example: A description of the resource.
    Category:
      type: string
      enum:
        - Appetizer
        - Main Course
        - Dessert
        - Drinks
      example: Main Course
      description: >
        Used to indicate where in the client app the dish should appear for
        ordering and used by the expediter to prioritize dishes for preparation.
    ImageName:
      type: string
      description: >
        The name of the image file related to a specific dish. When present, the
        image for the dish will appear in the client app with the other dish
        details.
      example: burger
    Ingredients:
      type: array
      description: The list of ingredients related to a specific dish.
      items:
        type: object
        properties:
          ingredient_id:
            type: string
            example: 66294b2a4475a41f3e709bc5
            description: >-
              The unique ingredient identifier, generated when the ingredient
              was created.
          is_essential:
            type: boolean
            example: true
            description: >
              When `true` the ingredient is required to prepare the dish. For
              essential ingredients, if the ingredient quantity is a
              non-positive value, the client app will disable the related dishes
              in the client app.
      example:
        - ingredient_id: 66294b2a4475a41f3e709bc5
          is_essential: true
        - ingredient_id: 66294b2a4475a41f3e709bc6
          is_essential: true
        - ingredient_id: 66294b2a4475a41f3e709bc7
          is_essential: false
    Price:
      type: number
      format: float
      example: 999
      description: The price used by the client app to calculate order cost.
    Station:
      type: string
      description: >
        The prep station responsible for preparing the dish. This value is used
        by the expeditor to prioritize and triage order preparation for the KDS
        stations.
      enum:
        - cold
        - hot
        - beverages
      example: hot

````