Get a run | AgentRouter | Developer Documentation

{
  "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
}

Reads stored state; never re-executes the provider. wait_ms (at most 60000) waits for a terminal status.

Authentication

AuthorizationBearer

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

Path parameters

run_idstringRequiredformat: "^run_[a-f0-9]{24}$"

Query parameters

wait_msintegerOptional0-60000

Response

The run receipt

objectany

run_idstring

statusenum

tool_idstring

tool_versionstring

providerstring

inputany

The submitted tool input

session_idstring or null

callerobject

channelenum

Allowed values:

created_atstring or null

started_atstring or null

completed_atstring or null

latency_msinteger or null

replayedboolean

True when an idempotency key returned an existing run.

stoppableboolean

provider_responseobject

errorobject or null

billingobject

resultobject

next_cursorstring or null

Pass back as the tool’s cursor input for the next page (a new billed call).

hintslist of objects

outputany

The provider's output exactly as returned

Errors

401

Unauthorized Error

404

Not Found Error