List scores
POST/api/v1/evals/list-scores
Lists recorded scores across their sources and evaluation targets.
Filtering by what the rating is about
conversationId and profileId answer "every rating on this conversation" and
"every rating on turns this agent profile produced". Each is decided per score —
on the score's own metadata, or on the trace it scores when the metadata does
not say — and combining them is an intersection. conversationId accepts a bare
thread id and qualifies it with your verified tenant.
Reading the result honestly
filterNarrowed matters when you paginate. Some filters cannot be applied by
the underlying store, so rows are removed after they are fetched: conversationId,
profileId, userId, the platform source values the store does not distinguish,
and the rows of the filters array. The response sets filterNarrowed: true
only when at least one row was removed from the pages fetched for this response.
It can remain false or be omitted even when these filters were evaluated. A page
may be shorter than pageSize or empty while cursorPage.nextCursor still leads
to more matches — keep following the cursor until it is omitted rather than
stopping at a short page. A false or omitted flag is not a complete-history or
consistent-snapshot guarantee. There is no total.
Deduplicate IDs across pages when collecting a report.
Score filters and result coverage
Current min/max score filters treat zero as unset; to apply a zero bound, collect the relevant permitted pages and filter in your application. See list-scores for supported filters.
Request
Responses
- 200
OK
Document ID: DOC-IS-evaluation-api-listScores. Section identities and revisions.
| Section | Stable reference |
|---|---|
| Overview | DOC-IS-evaluation-api-listScores#overview |
| Request | DOC-IS-evaluation-api-listScores#request |
| Responses | DOC-IS-evaluation-api-listScores#responses |
| Filtering by what the rating is about | DOC-IS-evaluation-api-listScores#filtering-by-what-the-rating-is-about |
| Reading the result honestly | DOC-IS-evaluation-api-listScores#reading-the-result-honestly |