For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
User GuideDeveloper GuidesAPI Reference
User GuideDeveloper GuidesAPI Reference
    • Overview
  • Runtype API
      • GETList agents
      • POSTCreate agent
      • POSTFetch external agent card
      • POSTRefresh cached agent card
      • GETGet agent details
      • PUTUpdate agent
      • DELDelete agent
      • GETExport agent for runtime
      • GETList agent executions
      • GETGet execution detail
      • GETList tool calls
      • GETGet tool call detail
      • POSTPublish agent
      • POSTAdd capability to agent
      • DELRemove capability from agent
Dashboard
LogoLogo
Runtype APIAgents

List agent executions

GET
/v1/agents/:id/executions
GET
/v1/agents/:id/executions
$curl https://api.runtype.com/v1/agents/id/executions \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json"
1{
2  "data": [
3    {
4      "id": "exec_9f8b7c6d5a4e3f21",
5      "agentId": "agent_12345abcde",
6      "agentSource": "runtype-core",
7      "executionId": "exec_9f8b7c6d5a4e3f21",
8      "parentExecutionId": null,
9      "surfaceType": "webhook",
10      "status": "completed",
11      "iterations": 3,
12      "totalCost": "0.023",
13      "stopReason": "max_iterations_reached",
14      "startedAt": "2024-06-10T14:22:30Z",
15      "completedAt": "2024-06-10T14:25:45Z",
16      "createdAt": "2024-06-10T14:22:00Z",
17      "agentSpec": null,
18      "totalTokens": 450,
19      "inputMessages": null
20    }
21  ],
22  "pagination": {
23    "nextCursor": "exec_9f8b7c6d5a4e3f22",
24    "prevCursor": "exec_9f8b7c6d5a4e3f20",
25    "hasMore": true,
26    "hasPrev": false,
27    "limit": 10,
28    "currentOffset": 0,
29    "totalPages": 5,
30    "currentPage": 1,
31    "totalCount": 47
32  }
33}

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

Was this page helpful?
Previous

Get execution detail

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Path parameters

idstringRequired

Query parameters

limitstringOptional
cursorstringOptional
includeCountstringOptional
statusstringOptional
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