---
title: "List scanned interactions (scorecards)"
method: GET
path: "/v1/trace/interactions"
tags: ["Trace"]
---

# List scanned interactions (scorecards)

`GET /v1/trace/interactions`

## Request

- Base URL: `https://api.pyai.com`
- URL: `https://api.pyai.com/v1/trace/interactions`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Cursor-paginated, newest first. Each row is one call's Tier-0 compliance scorecard. Filter by `verdict` (PASS/WARN/FAIL) or `agent_id`. Requires the `trace:read` scope.

## Query parameters

- `verdict` 'PASS' | 'WARN' | 'FAIL'
- `agent_id` string
- `limit` integer
- `cursor` string

## Response `200`

Interactions

- object
  - `object` string
  - `data` TraceInteraction[]
    - `object` string
    - `id` string: call_id
    - `agent_id` string, nullable
    - `product` 'hear' | 'speak' | 'clone' | 'cue' | 'omni' | 'agents' | 'null', nullable
    - `verdict` 'PASS' | 'WARN' | 'FAIL'
    - `findings` integer
    - `blocked_turns` integer
    - `modified_turns` integer
    - `packs_enforced` string
    - `scored_at` integer: Unix ms.
    - `source` string, nullable: Call origin, for example external.
  - `has_more` boolean
  - `next_cursor` string, nullable

## Other responses

- `401`: Missing or invalid API key (`code: unauthorized`)

---

[API](https://skmtc.dev/pyai/apis/pyai-api.md) · [All operations](https://skmtc.dev/pyai/apis/pyai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pyai/apis/pyai-api/revisions/819d8e7c4d09?raw)