> 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-sampling-rate.md).

# Get Agent Evaluation Sampling Rate

Compare the agent's configured evaluation sample\_size against the actually observed sampling rate for the period.

`actual_rate` is the share of the agent's executions in the period that ended up with an evaluation target (i.e. were not skipped by sampling), which can diverge from `configured_sample_size` for agents with few eligible runs.

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":{"EvaluationSamplingRateResponseSchema":{"properties":{"configured_sample_size":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Configured Sample Size","description":"The agent's configured eval_config.sample_size (0-100), or null if it has no evaluation config."},"actual_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Actual Rate","description":"evaluated_count / eligible_count * 100 for the period, or null if eligible_count is 0."},"evaluated_count":{"type":"integer","title":"Evaluated Count","description":"EXECUTION-type evaluation targets created in the period (i.e. not skipped by sampling)."},"eligible_count":{"type":"integer","title":"Eligible Count","description":"Every execution for the agent in the period, regardless of status."}},"type":"object","required":["configured_sample_size","actual_rate","evaluated_count","eligible_count"],"title":"EvaluationSamplingRateResponseSchema","description":"Configured vs. actually-observed evaluation sampling rate for an agent."}}},"paths":{"/api/v1/agents/{agent_id}/evaluations/sampling-rate":{"get":{"tags":["agents","public"],"summary":"Get Agent Evaluation Sampling Rate","description":"Compare the agent's configured evaluation sample_size against the\nactually observed sampling rate for the period.\n\n`actual_rate` is the share of the agent's executions in the period that\nended up with an evaluation target (i.e. were not skipped by sampling),\nwhich can diverge from `configured_sample_size` for agents with few\neligible runs.\n\nRequires platform administration role (admin or owner).","operationId":"agents-get_agent_evaluation_sampling_rate","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":"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/EvaluationSamplingRateResponseSchema"}}}},"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":{}}}}}}}}
```