> 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 runs"
description: "List run summaries: status, timing, retries, and LLM cost for each run."
method: "GET"
endpoint: "/api/v1/analytics/runs"
order: 1
last_verified: 2026-07-27
---



`GET /api/v1/analytics/runs`

List run summaries: status, timing, retries, and LLM cost for each run.


  ### Query parameters

  - `project_id` _string_ **required** — The project's UUID. Required.



  ### Request example


```bash
curl "https://api.agnt5.com/api/v1/analytics/runs?project_id=b6f1a3e2-9c4d-4f7a-8e2b-1a2b3c4d5e6f" \
  -H "X-API-KEY: {api_key}"
```

```javascript
fetch('https://api.agnt5.com/api/v1/analytics/runs?project_id=' + projectId, {
  headers: { 'X-API-KEY': apiKey }
})
```


  ```json {{ title: 'Response — a bare array, not the {success, data} envelope' }}
  [
    {
      "project_id": "b6f1a3e2-9c4d-4f7a-8e2b-1a2b3c4d5e6f",
      "deployment_id": "8a1c2d3e-...",
      "run_id": "7f6e5d4c-...",
      "component_id": "9b8a7c6d-...",
      "component_name": "process_invoice",
      "component_type": "workflow",
      "status": "completed",
      "enqueued_at": 1753612800000,
      "started_at": 1753612801000,
      "ended_at": 1753612805000,
      "duration_ms": 4000,
      "queue_time_ms": 1000,
      "total_time_ms": 5000,
      "step_count": 6,
      "retry_count": 0,
      "llm_call_count": 2,
      "llm_cost_usd": 0.0042,
      "trace_id": "4f6a2e1b8c9d7f3a5e2b1c4d6a8f9e0b"
    }
  ]
  ```