---
title: "List available menu items"
url: "https://kongair.terwilligar.com/apis/hot-diggity-dog/versions/7450374c-0e43-4067-b83d-ec33667f4a58/operations/listMenuItems"
---

> Full API specification: https://kongair.terwilligar.com/apis/hot-diggity-dog/versions/7450374c-0e43-4067-b83d-ec33667f4a58.md

# List available menu items

`GET` `/menu`

Operation ID: `listMenuItems`

Returns a list of available menu items.

## Query parameters

- `limit` (integer, int32, optional) - Maximum number of items to return
- `offset` (integer, int32, optional) - Number of items to skip for pagination

## Responses

- `200` - Successful operation

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Hot Dog Stand API
  version: 1.0.0
servers:
  - url: https://hotdog.example.com/api/v1
    description: Main server
paths:
  /menu:
    get:
      summary: List available menu items
      description: Returns a list of available menu items.
      operationId: listMenuItems
      tags:
        - Menu
      parameters:
        - name: limit
          in: query
          description: Maximum number of items to return
          schema:
            type: integer
            format: int32
            minimum: 1
            maximum: 100
            default: 20
        - name: offset
          in: query
          description: Number of items to skip for pagination
          schema:
            type: integer
            format: int32
            minimum: 0
            default: 0
      responses:
        "200":
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: "#/components/schemas/MenuItem"
                  meta:
                    type: object
                    properties:
                      page:
                        type: object
                        properties:
                          offset:
                            type: integer
                            description: The offset used for pagination.
                          limit:
                            type: integer
                            description: The limit used for pagination.
                          total:
                            type: integer
                            description: The total number of items available.
                          estimated_total:
                            type: boolean
                            description: Indicates if the total is estimated.
components:
  schemas:
    MenuItem:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the menu item
        name:
          type: string
          description: Name of the menu item
        description:
          type: string
          description: Description of the menu item
        price:
          type: number
          format: float
          description: Price of the menu item
      example:
        id: a1b2c3d4-e5f6-7890-1234-567890abcdef
        name: Hot Dog
        description: Classic hot dog on a bun
        price: 5
```