Skip to main content
GET
/
api
/
v1
/
guardrail-executions
List Guardrail Executions
curl --request GET \
  --url https://api.example.com/api/v1/guardrail-executions

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.

Returns the append-only audit log of guardrail evaluations the caller is allowed to see, newest first. Rows persist for 90 days (enforced by the BullMQ retention worker).

​
Authentication

Requires a Bearer token with the billing API key scope.

​
Query Parameters

​
limit
integer
Number of rows to return. 1–200, default 50.
​
key_id
string
Narrow to one API key (UUID).
​
policy_id
string
Narrow to one policy (UUID).
​
since
string
ISO timestamp. Returns rows created strictly after this time. Use this to tail the log.

​
Request Examples

# Most recent 20 evaluations for a single policy
curl "https://www.hitheo.ai/api/v1/guardrail-executions?limit=20&policy_id=$POLICY_ID" \
  -H "Authorization: Bearer $THEO_API_KEY"

# Tail every evaluation since a timestamp
curl "https://www.hitheo.ai/api/v1/guardrail-executions?since=2026-01-15T18:00:00.000Z" \
  -H "Authorization: Bearer $THEO_API_KEY"

​
Visibility

  • Personal callers (no active org): see only rows authored by themselves on personal policies.
  • Team callers: see every member’s rows on policies owned by the active org. Visibility follows the policy, not the user who triggered the row.

​
Response

{
  "executions": [
    {
      "id": "exec_abc123",
      "user_id": "user_xyz",
      "key_id": "key_abc",
      "policy_id": "1f4f2c1a-...",
      "policy_name": "Compliance-strict",
      "guardrail_id": "pii_redactor",
      "phase": "input",
      "verdict": "redact",
      "matched_pattern": "email,phone",
      "redacted_count": 2,
      "latency_ms": 1,
      "created_at": "2026-01-15T18:24:11.123Z"
    }
  ]
}