Read AI evaluation result

GET/ai/copilot/evals/{id}

Retrieves the current status and results of an evaluation run. Poll this endpoint after triggering a run via POST /evals until status transitions to "completed" or "failed". The score property contains the weighted aggregate score once the run completes.

Request

Path parameters

Name	Type	Required	Description
id	integer	Yes	The numeric ID of the evaluation run to fetch.

Responses

200 Evaluation run status and results

Content type application/json, object · AiEvaluationRunV1.

Field	Type	Required	Description
id	integer	No	Auto-incremented primary key.
suite_id	integer	No	ID of the suite that was executed.
status	string	No	Current execution status of the evaluation run. One of: "queued", "running", "completed", "failed"
score	number, nullable	No	Weighted aggregate score from 0 to 100. Null while still running.
pass_count	integer, nullable	No	Number of test cases that met their scoring thresholds.
fail_count	integer, nullable	No	Number of test cases that failed their scoring thresholds.
started_at	string (date-time), nullable	No
completed_at	string (date-time), nullable	No
created_at	string (date-time)	No

Example

{
  "id": 31,
  "suite_id": 5,
  "status": "completed",
  "score": 87.4,
  "pass_count": 18,
  "fail_count": 2,
  "started_at": "2026-04-08T11:00:15Z",
  "completed_at": "2026-04-08T11:02:43Z",
  "created_at": "2026-04-08T11:00:00Z"
}

404 Evaluation run not found

Example request

curl -X GET "https://{tenant}.faciotech.net/api/v1/ai/copilot/evals/{id}" \
  -H "Accept: application/json"