Skip to main content
GET
/
api
/
v1
/
violations
List Violations
curl --request GET \
  --url http://localhost:8000/api/v1/violations
{
  "violation_id": "<string>",
  "trace_id": "<string>",
  "span_id": "<string>",
  "eval_span_id": "<string>",
  "agent_id": "<string>",
  "guardrail_name": "<string>",
  "judge_model": "<string>",
  "decision": "<string>",
  "reason": "<string>",
  "evidence": "<string>",
  "severity": "<string>",
  "observed_at": "<string>",
  "provider": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.tracectrl.ai/llms.txt

Use this file to discover all available pages before exploring further.

Returns guardrail violations ordered newest first.

​
Query Parameters

​
limit
integer
default:"50"
Maximum rows to return.
​
agent_id
string
Filter by agent.
​
severity
string
Filter by severity (critical, high, medium, low).

​
Response

Array of Violation objects:
​
violation_id
string
Unique violation identifier
​
trace_id
string
Trace that produced the violation
​
span_id
string
Span being evaluated
​
eval_span_id
string
Span ID of the evaluation itself
​
agent_id
string
Agent that produced the offending output / received the offending input
​
guardrail_name
string
Guardrail that fired
​
judge_model
string
Model that produced the decision
​
decision
string
pass, fail, or error
​
reason
string
Judge’s reasoning
​
evidence
string
Evidence captured at evaluation time
​
severity
string
critical, high, medium, or low
​
observed_at
string
ISO-8601 timestamp
​
provider
string
judge_llm or protector_plus