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

# List Evaluations

> Retrieve all evaluation runs for a specific model, including status and risk summaries.

List every evaluation run associated with a model. The response includes the evaluation ID, current status, risk level, and any error message for each run.

## Endpoint

**GET** `/v1/models/{id}/evaluations`

Authentication: `Authorization: Bearer $ARIA_PIN_KEY`

## Path parameters

<ParamField path="id" type="string" required>
  The model ID whose evaluations you want to list.
</ParamField>

## Response

<ResponseField name="items" type="array">
  List of evaluation objects.

  <Expandable>
    <ResponseField name="eval_id" type="string">
      Unique identifier for the evaluation run.
    </ResponseField>

    <ResponseField name="status" type="string">
      Current status, such as `queued`, `running`, `succeeded`, or `failed`.
    </ResponseField>

    <ResponseField name="risk" type="string">
      Risk summary (for example, `ok`).
    </ResponseField>

    <ResponseField name="error" type="string">
      Error message if the run failed, otherwise an empty string.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp when the evaluation was created.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

```bash theme={null}
curl http://<pin-host>:8001/v1/models/mod_123/evaluations \
  -H "Authorization: Bearer $ARIA_PIN_KEY"
```

```json theme={null}
{
  "items": [
    {
      "eval_id": "ev_1712345678901234567",
      "status": "queued",
      "risk": "ok",
      "error": "",
      "created_at": "2025-06-01T12:00:00Z"
    }
  ]
}
```


## Related topics

- [Create Evaluation](/api-reference/pin/evaluations/create.md)
- [Get Evaluation](/api-reference/pin/evaluations/get.md)
- [Aria Compute PIN API: Post-Training & Evaluation](/api-reference/pin/introduction.md)
- [List Subagents](/api-reference/agent/subagents/list.md)
- [List PIN Models](/api-reference/pin/models/list.md)