**Version: 202601**

# List menus

**GET** `/openapi/2026-01/menus`

List the store's menus (navigation). Supports filtering by ids and hiding disabled items.

## Request

**Query Parameters**

- `ids` string[]

  Optional menu ids to filter; empty = all menus
- `hide_disabled` boolean

  When true, hide disabled menu items
- `page` int32

  Page number
- `page_size` int32

  Page size, defaults to 100

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `menus` object[]

    Menu list; each menu: `{id, title, category, children:[...]}`
  - `total` int32

    Total number of menus
  - `page` int32

    Current page number
  - `limit` int32

    Page size
  - `has_more` boolean

    Whether more pages exist

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "menus": [
      {}
    ],
    "total": 0,
    "page": 0,
    "limit": 0,
    "has_more": true
  }
}
```
