List evaluations
Returns a cursor-paginated list of evaluation results for a specific agent, newest first.
Only completed and failed evaluations are returned unless status selects another state.
Each evaluation includes the grade, criteria pass/fail results, extracted data points, applied tags, and sentiment analysis.
Authorizations
Path Parameters
ID of the agent whose evaluations to list. Also accepts the reserved aliases gumball and analytics.
Query Parameters
Number of evaluations to return per page (1-100).
1 <= x <= 100Pagination cursor from a previous response's next_cursor field.
Filter evaluations by grade.
pass, needs_review, needs_attention Return evaluations in one lifecycle state instead of the default completed and failed set.
queued, in_progress, completed, failed Only evaluations of this session.
Only evaluations created at or after this ISO 8601 timestamp. Timestamps without an offset are read as UTC.
Only evaluations created before this ISO 8601 timestamp. Timestamps without an offset are read as UTC.
