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

# Get Hook Executions

> View recent execution history for an installed hook.

Returns the most recent execution records for a hook (up to 50), newest first.

## Path Parameters

<ParamField path="id" type="string" required>
  The hook UUID.
</ParamField>

## Response

<ResponseField name="executions" type="array">
  Recent executions. Each entry includes `id`, `event_type`, `status`, `credits_used`, `execution_ms`, `skip_reason`, `error_message`, and `created_at`.
</ResponseField>

## Authentication

Requires an API key with `completions` scope.

## Example

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

### Response

```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"
    }
  ]
}
```