---
title: "List Flow Runs"
method: GET
path: "/analytics/org/{org_id}/flows/{flow_id}"
tags: ["analytics"]
---

# List Flow Runs

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

List flow run logs matching the given filters.

## Path parameters

- `flow_id` string, required
- `org_id` string, required

## Query parameters

- `page` integer
- `page_size` integer
- `start_date` string, date-time, nullable
- `end_date` string, date-time, nullable
- `user_id` string, nullable
- `state` string, nullable — Comma-separated list of statuses to filter by. Accepted values: PENDING, PAUSED, RESUMED, COMPLETED, FAILED, CANCELLED

## Response `200`

Successful Response

- ProjectRunSummary[]
  - `run_id` string, uuid, required
  - `conversation_id` string, nullable
  - `date` string, date-time, required
  - `is_flow_successful` boolean, nullable, required
  - `state` 'PENDING' | 'PAUSED' | 'RESUMED' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required — Enum representing the possible states of a workflow.
  - `error` string, nullable, required
  - `latency` number, nullable, required
  - `total_tokens` integer, required
  - `user_id` string, nullable, required
  - `inputs` string, nullable, required
  - `outputs` string, nullable, required
  - `llms` string, nullable, required
  - `feedback` string, nullable, required
  - `llm_usage` LLMUsageData[]
    - `provider` 'Anthropic' | 'Azure' | 'Bedrock' | 'Cerebras' | 'Google' | 'Google_service_account' | 'Groq' | 'Local' | 'Meta' | 'Mistral' | 'OpenAI' | 'Perplexity' | 'Replicate' | 'TogetherAI' | 'XAI', required — LLM provider identifiers.
    - `model_id` string, required
    - `tokens` integer, nullable
    - `input_tokens` integer, nullable
    - `output_tokens` integer, nullable
    - `connection_id` string, uuid, nullable
    - `connection_origin` 'stack_ai' | 'external_db' | 'external_ephemeral'
    - `is_local_model` boolean, required — Whether this usage record is from a local model.
    - `should_charge` boolean, required — Whether this usage record should be charged.
  - `run_type` 'workflow_builder' | 'form' | 'batch' | 'chat_assistant' | 'agent_assistant' | 'trigger' | 'scheduled' | 'sub_workflow' | 'api' — How a workflow run was initiated.
  - `ran_by_type` 'user' | 'personal_api_key' | 'org_api_key' | 'system' — Who or what authenticated the run.
  - `ran_by_id` string, uuid, nullable — ID of the user or API key that triggered the run.
  - `ran_by_display_name` string, nullable — Display name of the user (email) or API key (name) that triggered the run.
  - `parent_run_id` string, uuid, nullable — Run ID of the parent workflow for sub-workflow runs.
  - `parent_project_id` string, nullable — Project ID of the parent workflow for sub-workflow runs.
  - `parent_project_name` string, nullable — Name of the parent project for sub-workflow runs.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/stack-ai/apis/stackai-api.md) · [All operations](https://skmtc.net/stack-ai/apis/stackai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stack-ai/stackai-api/revisions/ca7b37f9b908/schema)