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

# List Guardrail Executions

> Tail the append-only audit log of guardrail evaluations.

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

<ParamField query="limit" type="integer">
  Number of rows to return. 1–200, default 50.
</ParamField>

<ParamField query="key_id" type="string">
  Narrow to one API key (UUID).
</ParamField>

<ParamField query="policy_id" type="string">
  Narrow to one policy (UUID).
</ParamField>

<ParamField query="since" type="string">
  ISO timestamp. Returns rows created strictly after this time. Use this to tail the log.
</ParamField>

## Request Examples

<CodeGroup>
  ```bash curl theme={null}
  # 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"
  ```

  ```typescript SDK theme={null}
  const recent = await theo.guardrails.executions.list({
    policyId,
    limit: 20,
  });

  // Long-poll for new rows
  const since = new Date(Date.now() - 60_000).toISOString();
  const newRows = await theo.guardrails.executions.list({ since });
  ```
</CodeGroup>

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

```json theme={null}
{
  "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"
    }
  ]
}
```