> ## Documentation Index
> Fetch the complete documentation index at: https://developers.agentx.so/llms.txt
> Use this file to discover all available pages before exploring further.

# List Runs

> List the project's evaluation runs, newest first

Returns the project's most recent evaluation runs (up to 50), newest first. Each entry is the
same full run summary [Get Run](/api-reference/custom-eval/get-run) returns, including
`liveStatistics` and per-result rows.

<Note>
  There is no pagination on this endpoint - it returns at most the 50 newest runs and takes no
  query parameters. Fetch a specific run by id with
  [Get Run](/api-reference/custom-eval/get-run).
</Note>

## Authentication

<ParamField header="x-api-key" type="string" required>
  Project API key.
</ParamField>

## Response

<ResponseField name="runs" type="array">
  Up to 50 run objects, newest first, each in the
  [Get Run](/api-reference/custom-eval/get-run) shape: `_id`/`runId`, `datasetId`,
  `evaluationSettingsId`, `scorerGroupId`, `scorerGroupName`, `additionalScorerIds`,
  `scorerBreakdown`, `evaluationSubject`, `status`
  (`"in_progress"` | `"completed"` | `"failed"`), `resultCount`, `averageRating`,
  `liveStatistics`, `caseStatistics`, and `results`.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "http://localhost:4700/api/v1/custom-agent-evaluations/runs" \
    -H "x-api-key: agtx_local_0f3c9a17d2b84e6a5c01b9f4e7d8a2c6431b5f97a0e2d4c8"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "runs": [
      {
        "_id": "rK7dP2qWx9TzB4mV6nJcE",
        "runId": "rK7dP2qWx9TzB4mV6nJcE",
        "datasetId": "dS4tG7hNb2VxZ8kQ5wMyA",
        "evaluationSettingsId": null,
        "scorerGroupId": null,
        "scorerGroupName": null,
        "additionalScorerIds": null,
        "scorerBreakdown": [
          { "scorerId": null, "name": "Primary scorer", "primary": true, "averageRating": 7.8, "scored": 6 }
        ],
        "evaluationSubject": {
          "kind": "custom_agent",
          "displayName": "Customer Support Bot",
          "framework": "langchain"
        },
        "status": "completed",
        "resultCount": 6,
        "averageRating": 7.8,
        "liveStatistics": {
          "averageRating": 7.8,
          "minRating": 5,
          "maxRating": 10,
          "ratedCount": 6,
          "skippedCount": 0,
          "failedCount": 0
        },
        "caseStatistics": [],
        "results": [ { "questionIndex": 0, "rating": 8, "...": "..." } ]
      }
    ]
  }
  ```
</ResponseExample>