List agent executions | Runtype Documentation

{
  "data": [
    {
      "agentId": "agent_9f8b7c6d5e4a3b2c1d0e",
      "agentSource": "internal",
      "cancelRequestedAt": null,
      "completedAt": "2024-06-10T15:45:30Z",
      "createdAt": "2024-06-10T14:00:00Z",
      "executionId": "exec_1234567890abcdef",
      "executionMode": "attached",
      "expiresAt": "2024-06-17T14:00:00Z",
      "id": "run_abcdef1234567890",
      "iterations": 3,
      "lastHeartbeatAt": "2024-06-10T15:40:00Z",
      "notificationMode": "none",
      "parentAgentId": "agent_1122334455667788",
      "parentConversationId": "conv_9988776655443322",
      "parentExecutionId": "exec_0987654321fedcba",
      "parentToolCallId": "toolcall_1234abcd5678efgh",
      "pendingApproval": {
        "approvalId": "approval_5678efgh1234abcd",
        "requestedAt": "2024-06-10T15:30:00Z",
        "toolCallId": "toolcall_1234abcd5678efgh",
        "toolName": "ExternalAPIConnector",
        "toolType": "api",
        "description": "Approval required for external API call",
        "reason": "External API quota exceeded",
        "timeout": 3600
      },
      "retryOfExecutionId": null,
      "rootExecutionId": "exec_root_abcdef123456",
      "startedAt": "2024-06-10T14:05:00Z",
      "status": "queued",
      "stopReason": null,
      "surfaceType": "web",
      "totalCost": "0.023"
    }
  ],
  "pagination": {
    "currentOffset": 0,
    "hasMore": true,
    "hasPrev": false,
    "limit": 10,
    "nextCursor": "cursor_abcdef123456",
    "prevCursor": null,
    "currentPage": 1,
    "totalCount": 25,
    "totalPages": 3
  }
}

List execution history for an agent with cursor pagination. Supports cross-agent subagent drill-down via parentExecutionId or executionId filters.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

idstringRequired

Query parameters

limitstringOptional

cursorstringOptional

includeCountstringOptional

statusenumOptional

surfaceTypestringOptional

fromstringOptional

tostringOptional

parentExecutionIdstringOptional

executionIdstringOptional

Response

Paginated list of agent executions

datalist of objects

paginationobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl https://api.runtype.com/v1/agents/id/executions \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json"