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 flows
      • POSTCreate flow
      • GETGet flow details
      • PUTUpdate flow
      • DELDelete flow
      • GETExport flow for runtime (limited preview)
      • POSTPublish flow
      • POSTRun flow on records of a type
      • GETList flow step results
Dashboard
LogoLogo
Runtype APIFlows

List flow step results

GET
/v1/flows/:id/step-results
GET
/v1/flows/:id/step-results
$curl https://api.runtype.com/v1/flows/id/step-results \
>     -H "Authorization: <apiKey>" \
>     -H "Content-Type: application/json"
1{
2  "data": [
3    {
4      "batchExecutionId": "b7f3a9d2-4c1e-4f8a-9d3e-2a1b5c6d7e8f",
5      "completedAt": "2024-06-10T15:45:30Z",
6      "createdAt": "2024-06-10T15:40:00Z",
7      "durationMs": 330000,
8      "executionSessionId": "sess_9f8e7d6c5b4a3f2e1d0c",
9      "flowId": "flow_1234567890abcdef",
10      "flowVersionId": "v1.3.0",
11      "id": "stepres_abcdef1234567890",
12      "order": 2,
13      "organizationId": "org_9876543210fedcba",
14      "outputPreview": "The generated summary of the input text is concise and accurate.",
15      "recordId": "rec_20240610_001",
16      "recordName": "Customer Feedback Analysis",
17      "startedAt": "2024-06-10T15:40:30Z",
18      "status": "completed",
19      "stepId": "step_02",
20      "stepName": "Sentiment Analysis",
21      "stepType": "ai-processing",
22      "userId": "user_1234abcd5678efgh",
23      "completionTokens": 120,
24      "errorMessage": null,
25      "estimatedCost": "0.0045",
26      "modelUsed": "gpt-4o-mini",
27      "promptTokens": 85,
28      "resolvedPrompt": "Summarize the following customer feedback for sentiment analysis.",
29      "retryCount": 0,
30      "totalTokens": 205
31    }
32  ],
33  "pagination": {
34    "hasMore": false,
35    "limit": 25,
36    "offset": 0,
37    "returned": 1
38  }
39}
Get unified step execution results for a flow with filtering and offset pagination.
Was this page helpful?
Previous

List integration configs

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Path parameters

idstringRequired

Query parameters

recordIdstringOptional
batchIdstringOptional
statusstringOptional
stepIdstringOptional
fromstringOptional
tostringOptional
sortBystringOptional
sortOrderenumOptional
Allowed values:
limitstringOptional
offsetstringOptional

Response

Step results
datalist of objects
paginationobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error