Skip to main content
GET
/
v1
/
trace
/
findings
List Tier-2 semantic findings
curl --request GET \
  --url https://api.pyai.com/v1/trace/findings \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "data": [
    {
      "object": "trace.finding",
      "id": "<string>",
      "interaction_id": "<string>",
      "agent_id": "<string>",
      "check_id": "hallucination",
      "verdict": "concern",
      "confidence": 123,
      "reason": "<string>",
      "preempt_instruction": "<string>",
      "at_t": 123,
      "tier": 2
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
check_id
string
Example:

"hallucination"

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

Response

Findings

​
object
string
Example:

"list"

​
data
object[]
​
has_more
boolean
​
next_cursor
string | null