> ## 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.