Skip to main content
GET
/
v1
/
trace
/
interactions
List scanned interactions (scorecards)
curl --request GET \
  --url https://api.pyai.com/v1/trace/interactions \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "data": [
    {
      "object": "trace.interaction",
      "id": "<string>",
      "agent_id": "<string>",
      "findings": 123,
      "blocked_turns": 123,
      "modified_turns": 123,
      "packs_enforced": "<string>",
      "scored_at": 123
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

Authorizations

Authorization
string
header
required

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

Query Parameters

verdict
enum<string>
Available options:
PASS,
WARN,
FAIL
agent_id
string
limit
integer
default:20
Required range: 1 <= x <= 100
cursor
string

Response

Interactions

object
string
Example:

"list"

data
object[]
has_more
boolean
next_cursor
string | null