---
title: "GET /v1/levels"
method: GET
path: "/v1/levels"
tags: ["Level"]
---

# GET /v1/levels

`GET /v1/levels`

## Request

- The document declares no server URL.
- Auth: none declared

## Query parameters

- `page` integer
- `pageSize` integer
- `keyword` string
- `status` integer
- `type` integer

## Response `200`

OK

- MarksmanApiV1ListLevelReply
  - `total` string
  - `page` integer
  - `pageSize` integer
  - `items` MarksmanApiV1LevelItem[]
    - `uid` string
    - `name` string
    - `remark` string
    - `status` integer
    - `metadata` object
    - `createdAt` string
    - `updatedAt` string
    - `bgColor` string
    - `type` integer

## Changes

- **2026-03-25** `650c5b44c427`: 2 info
  - added the new optional `query` request parameter `type`
  - added the optional property `items/items/type` to the response with the `200` status
- **2026-03-24** `b6c8a3179fcc`: 1 info
  - added the optional property `items/items/bgColor` to the response with the `200` status
- **2026-02-28** `f5912329bb01`: 3 warning
  - deleted the `query` request parameter `type`
  - removed the optional property `items/items/bgColor` from the response with the `200` status
  - removed the optional property `items/items/type` from the response with the `200` status

[Operation history](https://skmtc.dev/aide-family/apis/aide-family-marksman-api/changes/v1/levels/get.md)

---

[API](https://skmtc.dev/aide-family/apis/aide-family-marksman-api.md) - [All operations](https://skmtc.dev/aide-family/apis/aide-family-marksman-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aide-family/apis/aide-family-marksman-api/revisions/26ae221fccba?raw)