Read one run

GET

/v1/runs/:executionId

GET

/v1/runs/:executionId

curl https://api.runtype.com/v1/runs/executionId \
     -H "Authorization: <apiKey>"

{
  "data": {
    "agentId": "string",
    "batchExecutionId": "string",
    "completeness": "partial",
    "conversationId": "string",
    "durationMs": 1.1,
    "endedAt": "string",
    "executionId": "string",
    "fidelityTier": "string",
    "flowId": "string",
    "inputTokens": 1.1,
    "kind": "agent",
    "outputTokens": 1.1,
    "parentExecutionId": "string",
    "parentToolCallId": "string",
    "recordId": "string",
    "rootExecutionId": "string",
    "selfReportedCost": "string",
    "source": "hosted",
    "spanCount": 1.1,
    "startedAt": "string",
    "status": "queued",
    "surfaceId": "string",
    "surfaceType": "string",
    "test": true,
    "totalCost": "string",
    "traceId": "string",
    "agentTargetResolution": "string",
    "agentVersionId": "string",
    "agentVersionLabel": "string",
    "agentVersionNumber": 1.1,
    "budgetExhausted": true,
    "cancelRequestedAt": "string",
    "expiresAt": "string",
    "inputMessages": null,
    "iterations": 1.1,
    "lastHeartbeatAt": "string",
    "otelProducer": null,
    "pendingApproval": null,
    "progress": null,
    "retentionElided": true,
    "stopReason": "string"
  }
}

One run the caller owns, in the row shape the list returns. An API key must hold the scope of the run’s own execution kind (AGENTS:READ or FLOWS:READ, and both when the run states neither). Use GET /v1/logs/trace/execution/{id} for its span tree.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

executionIdstringRequired

Query parameters

overlayenumOptional

live adds control-plane fields; defaults to live for a session, none for an API key.

Allowed values:

viewenumOptional

full (the default) returns every field. compact omits exactly these 14: stopReason, iterations, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ.

Allowed values:

Response

Run returned

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error