> 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
---

<ApiEndpoint
  method="GET"
  endpoint="/api/v1/analytics/runs"
  description="List run summaries: status, timing, retries, and LLM cost for each run."
>
  <section>
    ### Query parameters

    <ApiAttribute name="project_id" type="string" description="The project's UUID. Required." required={true} />
  </section>

  <section>
    ### Request example

    <MultiLanguageCodeBlock
      languages={["bash", "javascript"]}
      value={[
        {
          language: 'bash',
          code: `curl "https://api.agnt5.com/api/v1/analytics/runs?project_id=b6f1a3e2-9c4d-4f7a-8e2b-1a2b3c4d5e6f" \\
  -H "X-API-KEY: {api_key}"`
        },
        {
          language: 'javascript',
          code: `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"
      }
    ]
    ```
  </section>
</ApiEndpoint>