List runs | AgentRouter | Developer Documentation

{
  "object": null,
  "runs": [
    {
      "object": null,
      "run_id": "string",
      "status": "READY",
      "tool_id": "string",
      "tool_version": "string",
      "provider": "string",
      "input": null,
      "session_id": "string",
      "caller": {
        "type": "api_key",
        "name": "string"
      },
      "channel": "http",
      "created_at": "string",
      "started_at": "string",
      "completed_at": "string",
      "latency_ms": 1,
      "replayed": true,
      "stoppable": true,
      "provider_response": {
        "http_status": 1,
        "outcome": "success",
        "status": "string",
        "request_id": "string",
        "task_id": "string"
      },
      "error": {
        "code": "string",
        "message": "string",
        "origin": "provider",
        "retryable": true,
        "details": {
          "body": "string",
          "truncated": true
        }
      },
      "billing": {
        "status": "none",
        "reason": "charged",
        "currency": null,
        "pricing_version": "string",
        "price_multiplier": "string",
        "promotion_id": "string",
        "max_cost_usd": "0.0035",
        "reserved_usd": "0.0035",
        "base_charge_usd": "string",
        "customer_charge_usd": "0.0035",
        "customer_refund_usd": "0.0035",
        "net_charge_usd": "0.0035",
        "charge_is_new": true,
        "usage": {
          "unit": "string",
          "quantity": "string",
          "status": "known"
        }
      },
      "result": {
        "available": true,
        "expired": true,
        "bytes": 1,
        "expires_at": "string",
        "url": "string",
        "inline": true
      },
      "next_cursor": "string",
      "hints": [
        {
          "code": "string",
          "message": "string",
          "params": {}
        }
      ],
      "output": null
    }
  ],
  "next_cursor": "string",
  "previous_cursor": "string"
}

Newest first. Output is not inlined; fetch a run or its result for data.

Authentication

AuthorizationBearer

An AgentRouter API key or an OAuth access token issued to an MCP host or the CLI.

Query parameters

statusstringOptional

A run status, or running for READY, RUNNING and STOPPING.

tool_idstringOptional

session_idstringOptional

caller_idstringOptional

API key id or OAuth grant id.

limitintegerOptional1-100Defaults to 20

cursorstringOptional

Use next_cursor for older runs or previous_cursor for newer runs. Keep the same filters and limit.

Response

A page of runs

objectany

runslist of objects

next_cursorstring or null

previous_cursorstring or null

Errors

401

Unauthorized Error