**版本：202601**

# 查询订单风险记录列表

**GET** `/openapi/2026-01/orders/:order_id/risks/list`

返回指定订单上的自定义风险记录列表，使用 cursor 分页，每页最多 page\_size 条 （1-100，默认 10）；翻页时传入上一次响应中的 cursor。

## 请求

**Path参数**

- `order_id` string (required)

  订单 ID

**Query参数**

- `cursor` string

  分页游标
- `page_size` int32

  每页记录数（1-100，默认 10）
- `page` int32

  页码（从 1 开始），与 cursor 互斥

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `risks` object[]

    订单风险记录列表

    *   Array \[

    - `id` string

      订单风险记录 ID
    - `order_id` string

      该风险记录关联的订单 ID
    - `level` string

      订单风险等级：

      *   `low`: 低
      *   `medium`: 中
      *   `high`: 高
    - `details` string[]

      说明风险标记原因的详情列表
    - `properties` object

      订单风险的自定义属性，以键值对形式存储

      - `property name*` string
    - `created_at` string

      风险记录创建时间（如 2018-11-02T12:30:10Z）
    - `updated_at` string

      风险记录最后更新时间（如 2018-11-02T12:30:10Z）
    *   \]
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否有更多记录

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "risks": [
      {
        "id": "string",
        "order_id": "string",
        "level": "string",
        "details": [
          "string"
        ],
        "properties": {},
        "created_at": "string",
        "updated_at": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}
```