> For the complete documentation index, see [llms.txt](https://developers.hotishop.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.hotishop.com/open-api/2024-10-latest-stable/webhook/list.md).

# 获取 Webhook 列表

<mark style="color:blue;">`GET`</mark>` ``/openapi/2024-10/webhooks`

权限:有应用权限都可获取Webhook列表

**Query参数**

|          参数名         |                                 说明                                |  必填 |   类型   |
| :------------------: | :---------------------------------------------------------------: | :-: | :----: |
|         page         |                               页码，默认1                              |  否  | string |
|      page\_size      |                             页面大小，默认50                             |  否  | string |
|   filter\[address]   |                                订阅地址                               |  否  | string |
| filter\[created\_at] |                               最大创建时间                              |  否  | string |
|    filter\[fields]   |                            显示字段列表，逗号分隔                            |  否  | string |
|  filter\[since\_id]  |                                起始ID                               |  否  | string |
|    filter\[topic]    | [订阅事件](/open-api/usage/webhook-intro.md#webhook-shi-jian-zhi-chi) |  否  | string |
| filter\[updated\_at] |                               最小更新时间                              |  否  | string |

**示例响应内容**

```json
{
    "data": [
        {
            "id": 2,
            "address": "http://mytest.com",
            "topic": "app/uninstalled",
            "created_at": "2021-10-13T14:21:02+08:00",
            "updated_at": "2021-10-13T14:21:02+08:00",
            "format": "json",
            "fields": [
                "id",
                "updated_at"
            ],
            "metafield_namespaces": [
                ""
            ],
            "api_version": ""
        }
    ],
    "links": {
        "first": "http://mytest.com/openapi/2024-10/webhooks?page=1",
        "last": "http://mytest.com/openapi/2024-10/webhooks?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "http://mytest.com/openapi/2024-10/webhooks",
        "per_page": 15,
        "to": 1,
        "total": 1
    }
}
```