Skip to main content
GET
/
api
/
v1
/
hooks
/
{id}
Get Hook Executions
curl --request GET \
  --url https://api.example.com/api/v1/hooks/{id}
{
  "executions": [
    {}
  ]
}
Returns the most recent execution records for a hook (up to 50), newest first.

​
Path Parameters

​
id
string
required
The hook UUID.

​
Response

​
executions
array
Recent executions. Each entry includes id, event_type, status, credits_used, execution_ms, skip_reason, error_message, and created_at.

​
Authentication

Requires an API key with completions scope.

​
Example

curl
curl https://www.hitheo.ai/api/v1/hooks/HOOK_ID \
  -H "Authorization: Bearer $THEO_API_KEY"

​
Response

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