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

# List Violations

> Guardrail violations with optional filtering

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`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.