> For the complete documentation index, see [llms.txt](/llms.txt).
> A full single-fetch corpus is available at [llms-full.txt](/llms-full.txt).
---
title: "List annotations"
description: "List the human annotations recorded on a run item, newest first."
method: "GET"
endpoint: "/api/v1/projects/:projectId/eval/runs/:runId/items/:runItemId/annotations"
order: 20
group: "Review and rescore"
last_verified: 2026-10-08
---



`GET /api/v1/projects/:projectId/eval/runs/:runId/items/:runItemId/annotations`

List the human annotations recorded on a run item, newest first.


  ## Parameters

  - `projectId` _string_ **required** — The project UUID.
  - `runId` _string_ **required** — The experiment run UUID.
  - `runItemId` _string_ **required** — The run item UUID, from Run failures or the run items.



  ## Request example


```bash
curl "https://api.agnt5.com/api/v1/projects/{project_id}/eval/runs/{run_id}/items/{run_item_id}/annotations" \
  -H "X-API-KEY: {api_key}"
```

```javascript
fetch('https://api.agnt5.com/api/v1/projects/' + projectId + '/eval/runs/' + runId + '/items/' + runItemId + '/annotations', {
  headers: { 'X-API-KEY': apiKey }
})
```


  ```json {{ title: 'Response' }}
  {
    "success": true,
    "message": "Annotations retrieved",
    "data": [
      { "id": "3ef4a15a-...", "name": "human_label", "label": "fail", "metadata": {}, "created_at": 1791493556306 },
      { "id": "3d1d42be-...", "name": "human_label", "label": "pass", "metadata": { "reviewer": "alice" }, "created_at": 1791493555997 }
    ],
    "metadata": { "count": 2, "page": 1, "hasNext": false, "hasPrev": false }
  }
  ```