> 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/get-agent-evaluation-summary.md).

# Get Agent Evaluation Summary

Get evaluation pass/fail counts and average overall\_score for an agent, grouped by time period.

For DAY/MONTH/YEAR grouping, the result is zero-filled: one entry per calendar period in range, even where there is no data. 400 if that range would span more than 1000 periods — narrow `daterange` or use a coarser `group`.

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":{"UsageGrouping":{"type":"string","enum":["TOTAL","DAY","MONTH","YEAR"],"title":"UsageGrouping","description":"Time-period granularity for aggregated execution usage."},"EvaluationTargetType":{"type":"string","enum":["execution","message","conversation"],"title":"EvaluationTargetType","description":"What kind of thing a metric is being computed for."},"EvaluationSummaryResponseSchema":{"properties":{"items":{"items":{"$ref":"#/components/schemas/EvaluationSummaryPeriodSchema"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"EvaluationSummaryResponseSchema","description":"Evaluation pass/fail and score summary response grouped by time period."},"EvaluationSummaryPeriodSchema":{"properties":{"period":{"type":"string","title":"Period","description":"Period label (e.g. '2024-01-15', '2024-01', '2024')"},"passed_count":{"type":"integer","title":"Passed Count","description":"Targets with eval_passed = true."},"failed_count":{"type":"integer","title":"Failed Count","description":"Targets with eval_passed = false."},"not_evaluated_count":{"type":"integer","title":"Not Evaluated Count","description":"Targets with no eval_passed recorded yet (evaluation not finished)."},"average_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Average Score","description":"Average overall_score across targets with a recorded score, or null if none."}},"type":"object","required":["period","passed_count","failed_count","not_evaluated_count","average_score"],"title":"EvaluationSummaryPeriodSchema","description":"Evaluation pass/fail counts and average overall_score for a single time period."}}},"paths":{"/api/v1/agents/{agent_id}/evaluations":{"get":{"tags":["agents","public"],"summary":"Get Agent Evaluation Summary","description":"Get evaluation pass/fail counts and average overall_score for an agent, grouped by time period.\n\nFor DAY/MONTH/YEAR grouping, the result is zero-filled: one entry per\ncalendar period in range, even where there is no data. 400 if that range\nwould span more than 1000 periods — narrow `daterange` or use a coarser\n`group`.\n\nRequires platform administration role (admin or owner).","operationId":"agents-get_agent_evaluation_summary","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":"group","in":"query","required":false,"schema":{"$ref":"#/components/schemas/UsageGrouping","description":"Time grouping granularity (DAY, MONTH, YEAR, or TOTAL). Defaults to DAY if omitted.","default":"DAY"},"description":"Time grouping granularity (DAY, MONTH, YEAR, or TOTAL). Defaults to DAY if omitted."},{"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). Defaults to all types combined.","title":"Target Type"},"description":"Restrict to one target type (execution, message, or conversation). Defaults to all types combined."},{"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/EvaluationSummaryResponseSchema"}}}},"400":{"description":"Invalid request payload or parameters","content":{"application/json":{}}},"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":{}}}}}}}}
```