> For the complete documentation index, see [llms.txt](https://docs.ibexa.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ibexa.ai/developers/rest-api/agents/list-agent-evaluation-targets.md).

# List Agent Evaluation Targets

List individual evaluation targets for an agent, newest first — the drill-down behind a summary count like "302 awaiting evaluation" or a metric's pass/fail total.

Reads live evaluation state directly, not the once-daily rollup used by the summary/breakdown endpoints, so a target evaluated moments ago already appears here. Filters compose: supplying both `target_type` and `outcome` narrows to their intersection. Note that only the run-level outcome is stored, so `outcome=failed` cannot be narrowed further to "failed because of metric X" — see the detail endpoint for a target's raw per-metric values.

Requires platform administration role (admin or owner).

```json
{"openapi":"3.1.0","info":{"title":"Ibexa Agentic Marketing Platform","version":"0.1.0"},"security":[{"OAuth2PasswordBearer":[]}],"components":{"securitySchemes":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"/api/v1/login/access-token"}}}},"schemas":{"EvaluationTargetType":{"type":"string","enum":["execution","message","conversation"],"title":"EvaluationTargetType","description":"What kind of thing a metric is being computed for."},"EvaluationOutcome":{"type":"string","enum":["passed","failed","not_evaluated"],"title":"EvaluationOutcome","description":"An evaluation target's run-level result, derived from `eval_passed`.\n\n`NOT_EVALUATED` maps to `eval_passed IS NULL` (evaluation not finished\nyet, e.g. still queued or skipped by sampling before this target was\ncreated). This is deliberately the run-level aggregate only — per-metric\npass/fail is tracked separately (`EvaluationResultRecord.passed`), so\nfiltering/grouping by this enum still can't distinguish \"which metric\nfailed\"; use the per-metric results for that."},"EvaluationTargetListResponseSchema":{"properties":{"data":{"items":{"$ref":"#/components/schemas/EvaluationTargetListItemResponseSchema"},"type":"array","title":"Data"},"total_count":{"type":"integer","title":"Total Count"}},"type":"object","required":["data","total_count"],"title":"EvaluationTargetListResponseSchema","description":"Paginated evaluation-target drill-down list response."},"EvaluationTargetListItemResponseSchema":{"properties":{"id":{"type":"integer","title":"Id"},"target_type":{"$ref":"#/components/schemas/EvaluationTargetType"},"execution_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Execution Id"},"message_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Message Id"},"conversation_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Conversation Id"},"overall_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Overall Score","description":"Weighted average across every computed metric, or null until evaluation finishes."},"outcome":{"$ref":"#/components/schemas/EvaluationOutcome"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","target_type","execution_id","message_id","conversation_id","overall_score","outcome","created_at"],"title":"EvaluationTargetListItemResponseSchema","description":"One row of the evaluation-target drill-down list — a lean projection,\nwith no per-metric results (see `EvaluationTargetDetailResponseSchema`)."}}},"paths":{"/api/v1/agents/{agent_id}/evaluations/targets":{"get":{"tags":["agents","public"],"summary":"List Agent Evaluation Targets","description":"List individual evaluation targets for an agent, newest first — the\ndrill-down behind a summary count like \"302 awaiting evaluation\" or a\nmetric's pass/fail total.\n\nReads live evaluation state directly, not the once-daily rollup used by\nthe summary/breakdown endpoints, so a target evaluated moments ago\nalready appears here. Filters compose: supplying both `target_type` and\n`outcome` narrows to their intersection. Note that only the run-level\noutcome is stored, so `outcome=failed` cannot be narrowed further to\n\"failed because of metric X\" — see the detail endpoint for a target's\nraw per-metric values.\n\nRequires platform administration role (admin or owner).","operationId":"agents-list_agent_evaluation_targets","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"integer","title":"Agent Id"}},{"name":"organisation_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Organisation ID. Defaults to the caller's own organisation. Superusers may specify any organisation.","title":"Organisation Id"},"description":"Organisation ID. Defaults to the caller's own organisation. Superusers may specify any organisation."},{"name":"target_type","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EvaluationTargetType"},{"type":"null"}],"description":"Restrict to one target type (execution, message, or conversation).","title":"Target Type"},"description":"Restrict to one target type (execution, message, or conversation)."},{"name":"outcome","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EvaluationOutcome"},{"type":"null"}],"description":"Restrict to one outcome (passed, failed, or not_evaluated).","title":"Outcome"},"description":"Restrict to one outcome (passed, failed, or not_evaluated)."},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum number of evaluation targets to return","default":25,"title":"Limit"},"description":"Maximum number of evaluation targets to return"},{"name":"daterange","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date range as 'start,end' (ISO 8601 dates). Either part can be omitted, e.g. '2024-01-01,2024-12-31', '2024-01-01,' or ',2024-12-31'. A single date without a comma (e.g. '2024-01-01') is also accepted and sets date_from with an open-ended date_to.","title":"Daterange"},"description":"Date range as 'start,end' (ISO 8601 dates). Either part can be omitted, e.g. '2024-01-01,2024-12-31', '2024-01-01,' or ',2024-12-31'. A single date without a comma (e.g. '2024-01-01') is also accepted and sets date_from with an open-ended date_to."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvaluationTargetListResponseSchema"}}}},"401":{"description":"User not authenticated","content":{"application/json":{}}},"403":{"description":"User lacks permission","content":{"application/json":{}}},"404":{"description":"Resource not found or user has no permission to access it","content":{"application/json":{}}}}}}}}
```