Analytics

List Flow Runs

get

List flow run logs matching the given filters.

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Authorization header. Learn how to get it.

Token URL:

Path parameters

flow_idstringRequired

org_idstringRequired

Query parameters

pageintegerOptionalDefault: 0

page_sizeinteger · min: 1OptionalDefault: 25

start_dateany ofOptional

string · date-timeOptional

or

nullOptional

end_dateany ofOptional

string · date-timeOptional

or

nullOptional

user_idany ofOptional

stringOptional

or

nullOptional

stateany ofOptional

Comma-separated list of statuses to filter by. Accepted values: PENDING, PAUSED, RESUMED, COMPLETED, FAILED, CANCELLED

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

Summary of a single workflow run.

run_idstring · uuidRequired

conversation_idany ofOptional

stringOptional

or

nullOptional

datestring · date-timeRequired

is_flow_successfulany ofRequired

booleanOptional

or

nullOptional

stateany ofRequired

string · enumOptional

Enum representing the possible states of a workflow.

Possible values:

or

nullOptional

errorany ofRequired

stringOptional

or

nullOptional

latencyany ofRequired

numberOptional

or

nullOptional

total_tokensintegerRequired

user_idany ofRequired

stringOptional

or

nullOptional

inputsany ofRequired

stringOptional

or

nullOptional

outputsany ofRequired

stringOptional

or

nullOptional

llmsany ofRequired

stringOptional

or

nullOptional

feedbackany ofRequired

stringOptional

or

nullOptional

run_typeany ofOptional

How the run was initiated.

string · enumOptional

How a workflow run was initiated.

Possible values:

or

nullOptional

ran_by_typeany ofOptional

Who authenticated the run.

string · enumOptional

Who or what authenticated the run.

Possible values:

or

nullOptional

ran_by_idany ofOptional

ID of the user or API key that triggered the run.

string · uuidOptional

or

nullOptional

ran_by_display_nameany ofOptional

Display name of the user (email) or API key (name) that triggered the run.

stringOptional

or

nullOptional

parent_run_idany ofOptional

Run ID of the parent workflow for sub-workflow runs.

string · uuidOptional

or

nullOptional

parent_project_idany ofOptional

Project ID of the parent workflow for sub-workflow runs.

stringOptional

or

nullOptional

parent_project_nameany ofOptional

Name of the parent project for sub-workflow runs.

stringOptional

or

nullOptional

422

Validation Error

application/json

get

/analytics/org/{org_id}/flows/{flow_id}

HTTPcURLJavaScriptPython

GET /analytics/org/{org_id}/flows/{flow_id} HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "run_id": "123e4567-e89b-12d3-a456-426614174000",
    "conversation_id": "text",
    "date": "2026-05-18T20:49:23.901Z",
    "is_flow_successful": true,
    "state": "PENDING",
    "error": "text",
    "latency": 1,
    "total_tokens": 1,
    "user_id": "text",
    "inputs": "text",
    "outputs": "text",
    "llms": "text",
    "feedback": "text",
    "llm_usage": [
      {
        "provider": "Anthropic",
        "model_id": "text",
        "tokens": 1,
        "input_tokens": 1,
        "output_tokens": 1,
        "connection_id": "123e4567-e89b-12d3-a456-426614174000",
        "connection_origin": "stack_ai",
        "is_local_model": true,
        "should_charge": true
      }
    ],
    "run_type": "workflow_builder",
    "ran_by_type": "user",
    "ran_by_id": "123e4567-e89b-12d3-a456-426614174000",
    "ran_by_display_name": "text",
    "parent_run_id": "123e4567-e89b-12d3-a456-426614174000",
    "parent_project_id": "text",
    "parent_project_name": "text"
  }
]