**Version: 202601**

# List categories

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

List all categories in the shop

## Request

**Query Parameters**

- `pid` uint64

  Pid of the category
- `ids` uint64[]

  ID of the categories. Example: ?ids=1001&ids=1002

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `categories` object[]

    List of categories

    *   Array \[

    - `id` uint64

      The ID of the category
    - `name` string

      The name of the category
    - `pid` uint64

      The parent ID of the category
    - `level` int32

      The level of the category
    - `position` int32

      The position of the category
    - `path` string

      The path of the category
    - `google_id` int32

      The google ID of the category
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "categories": [
      {
        "id": 0,
        "name": "string",
        "pid": 0,
        "level": 0,
        "position": 0,
        "path": "string",
        "google_id": 0
      }
    ]
  }
}
```