> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitheo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取钩子执行记录

> 查看已安装钩子的最近执行历史。

返回某个钩子最近的执行记录（最多 50 条），按时间从新到旧排列。

## 路径参数

<ParamField path="id" type="string" required>
  钩子 UUID。
</ParamField>

## 响应

<ResponseField name="executions" type="array">
  最近的执行记录。每条记录包含 `id`、`event_type`、`status`、`credits_used`、`execution_ms`、`skip_reason`、`error_message` 和 `created_at`。
</ResponseField>

## 身份验证

需要具有 `completions` 权限范围的 API 密钥。

## 示例

```bash curl theme={null}
curl https://www.hitheo.ai/api/v1/hooks/HOOK_ID \
  -H "Authorization: Bearer $THEO_API_KEY"
```

### 响应

```json theme={null}
{
  "executions": [
    {
      "id": "exec_a1b2c3",
      "event_type": "order.shipped.completed",
      "status": "success",
      "credits_used": 12,
      "execution_ms": 1840,
      "skip_reason": null,
      "error_message": null,
      "created_at": "2026-05-20T14:03:00.000Z"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.