Skip to main content
GET
/
v1
/
trace
/
violations
List violations (findings)
curl --request GET \
  --url https://api.pyai.com/v1/trace/violations \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "data": [
    {
      "object": "trace.violation",
      "id": "<string>",
      "interaction_id": "<string>",
      "agent_id": "<string>",
      "rule_id": "tcpa-003",
      "pack_id": "tcpa",
      "citation": "<string>",
      "reason": "<string>",
      "at_t": 123
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

Authorizations

Authorization
string
header
required

Use Authorization: Bearer pyai_live_... (or pyai_test_...).

Query Parameters

rule_id
string
severity
enum<string>
Available options:
low,
medium,
high,
critical
interaction_id
string
limit
integer
default:20
Required range: 1 <= x <= 100
cursor
string

Response

Violations

object
string
Example:

"list"

data
object[]
has_more
boolean
next_cursor
string | null