Skip to main content
GET
/
v1
/
runs
Search runs
curl --request GET \
  --url https://api.runflow.io/v1/runs \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "flow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "model_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "comfyui_workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "target_version": "<string>",
      "org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "input": {},
      "output": {},
      "context": {},
      "duration_ms": 123,
      "cost": "<string>",
      "cost_breakdown": {},
      "nodes_total": 123,
      "nodes_completed": 123,
      "resolved_template_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "batch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "client_ref": "<string>",
      "jurisdiction_code": "<string>",
      "flow_version_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "request_id": "<string>",
      "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "started_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z",
      "callback_url": "<string>",
      "metadata": {},
      "has_logs": true,
      "has_node_runs": true,
      "links": {},
      "failure_code": "<string>",
      "failure_message": "<string>",
      "feedback_is_positive": true,
      "feedback_reason": "<string>",
      "source_chat_message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "current_evaluation_summary": {
        "passed": true,
        "status_code": "<string>",
        "score": 0.5
      },
      "node_runs": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "node_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "flow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "state_code": "<string>",
          "input": {},
          "output": {},
          "input_signature": "<string>",
          "preview_type": "<string>",
          "preview_value": "<string>",
          "duration_ms": 123,
          "cost": "<string>",
          "retry_count": 123,
          "error_message": "<string>",
          "created_at": "2023-11-07T05:31:56Z",
          "started_at": "2023-11-07T05:31:56Z",
          "completed_at": "2023-11-07T05:31:56Z"
        }
      ],
      "logs": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "level_code": "<string>",
          "message": "<string>",
          "timestamp": "2023-11-07T05:31:56Z",
          "meta": {},
          "run": null
        }
      ],
      "model": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "model_creator_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "slug": "<string>",
        "name": "<string>",
        "description": "<string>",
        "version": "<string>",
        "is_public": true,
        "is_open_source": true,
        "icon_url": "<string>",
        "cover_url": "<string>",
        "category_code": "<string>",
        "status_code": "<string>",
        "family_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "family_variant_code": "<string>",
        "param_count": "<string>",
        "architecture": "<string>",
        "license_code": "<string>",
        "max_resolution": "<string>",
        "lora_support": true,
        "fine_tuning": true,
        "supports_streaming": true,
        "paper_url": "<string>",
        "github_url": "<string>",
        "is_official": true,
        "availability_status": "<string>",
        "seo": {},
        "notable_features": [
          "<unknown>"
        ],
        "content": "<string>",
        "pricing_note": "<string>",
        "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "deleted_at": "2023-11-07T05:31:56Z",
        "deleted_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "inputs": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "model_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "name": "<string>",
            "display_name": "<string>",
            "description": "<string>",
            "variable_type_code": "<string>",
            "default_behavior_code": "<string>",
            "validator_code": "<string>",
            "validator_attrs": {},
            "is_required": true,
            "default_value": {},
            "sort_order": 123,
            "is_featured": true,
            "created_at": "2023-11-07T05:31:56Z",
            "updated_at": "2023-11-07T05:31:56Z"
          }
        ],
        "outputs": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "model_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "name": "<string>",
            "display_name": "<string>",
            "description": "<string>",
            "variable_type_code": "<string>",
            "validator_code": "<string>",
            "validator_attrs": {},
            "sort_order": 123,
            "created_at": "2023-11-07T05:31:56Z",
            "updated_at": "2023-11-07T05:31:56Z"
          }
        ],
        "examples": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "model_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "title": "<string>",
            "description": "<string>",
            "input": {},
            "output": {},
            "status_code": 123,
            "cost": "<string>",
            "start_type": "<string>",
            "timing": {},
            "duration_ms": 123,
            "total_ms": 123,
            "thumbnail_url": "<string>",
            "category_code": "<string>",
            "is_featured": true,
            "is_public": true,
            "sort_order": 123,
            "ran_at": "2023-11-07T05:31:56Z",
            "created_at": "2023-11-07T05:31:56Z",
            "updated_at": "2023-11-07T05:31:56Z"
          }
        ],
        "faq_entries": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "model_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "question": "<string>",
            "answer": "<string>",
            "sort_order": 123,
            "created_at": "2023-11-07T05:31:56Z",
            "updated_at": "2023-11-07T05:31:56Z"
          }
        ],
        "pricing": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "model_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "pricing_model_code": "<string>",
            "rule_effect_code": "<string>",
            "model_input_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "match_value": null,
            "dimension_code": "<string>",
            "min_value": "<string>",
            "max_value": "<string>",
            "price": "<string>",
            "currency_code": "<string>",
            "unit_code": "<string>",
            "multiplier_label": "<string>",
            "description": "<string>",
            "sort_order": 123,
            "disabled_at": "2023-11-07T05:31:56Z",
            "measurement_source": "<string>",
            "created_at": "2023-11-07T05:31:56Z",
            "updated_at": "2023-11-07T05:31:56Z"
          }
        ],
        "related_links": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "model_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "related_model_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "sort_order": 123,
            "created_at": "2023-11-07T05:31:56Z"
          }
        ]
      },
      "comfyui_workflow": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "slug": "<string>",
        "name": "<string>",
        "description": "<string>",
        "workflow_json": {},
        "version": "<string>",
        "is_public": true,
        "status_code": "<string>",
        "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "environment": {},
        "models": {},
        "custom_nodes": {},
        "graph": {},
        "resources": {},
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "deleted_at": "2023-11-07T05:31:56Z",
        "deleted_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "category_code": "<string>",
        "gpu_current_tier_code": "<string>",
        "inputs": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "comfyui_workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "name": "<string>",
            "display_name": "<string>",
            "description": "<string>",
            "variable_type_code": "<string>",
            "default_behavior_code": "<string>",
            "validator_code": "<string>",
            "validator_attrs": {},
            "is_required": true,
            "default_value": {},
            "sort_order": 123,
            "comfyui_node_id": "<string>",
            "comfyui_field_name": "<string>",
            "created_at": "2023-11-07T05:31:56Z",
            "updated_at": "2023-11-07T05:31:56Z"
          }
        ],
        "outputs": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "comfyui_workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "name": "<string>",
            "display_name": "<string>",
            "description": "<string>",
            "variable_type_code": "<string>",
            "validator_code": "<string>",
            "validator_attrs": {},
            "sort_order": 123,
            "comfyui_node_id": "<string>",
            "comfyui_field_name": "<string>",
            "created_at": "2023-11-07T05:31:56Z",
            "updated_at": "2023-11-07T05:31:56Z"
          }
        ],
        "gpu_explicit_models": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "comfyui_workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "gpu_model_code": "<string>",
            "created_at": "2023-11-07T05:31:56Z"
          }
        ]
      }
    }
  ],
  "first": "<string>",
  "next": "<string>",
  "previous": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
X-Organization-Id
string | null

Query Parameters

​
evaluation_issue_category
string | null

Filter to runs whose current evaluation (completed and not superseded) has at least one evaluation_issue with this category. Superseded or non-completed evaluations are ignored, so a retried run whose latest evaluation passed will not match.

​
evaluation_issue_subcategory
string | null

Filter to runs whose current evaluation (completed and not superseded) has at least one evaluation_issue with this subcategory. When combined with evaluation_issue_category both must match the same issue row. Superseded or non-completed evaluations are ignored.

​
evaluation_status
enum<string> | null

Filter by the run's current evaluation verdict. passed / failed require a completed non-superseded evaluation with overall_passed set to true / false respectively (three-valued logic — neither matches a NULL verdict). not_evaluated matches the UI's "Not analyzed" badge: either no completed non-superseded evaluation exists (no-eval, pending, judge-errored, or superseded-only) OR the current evaluation completed without emitting a verdict (overall_passed IS NULL). Combined with evaluation_issue_category / evaluation_issue_subcategory, both predicates resolve against the same evaluation row (by the data invariant that at most one current evaluation exists per run).

Available options:
passed,
failed,
not_evaluated
​
q
string | null

ANTLR filter expression

​
limit
integer | null

Page size

Required range: 1 <= x <= 500
​
sort_by
string | null

Sort expression (e.g. created_at:desc)

​
fields
string | null

Field projection (e.g. id,name)

​
embed
string | null

Relation embedding. Available values: comfyui_workflow, current_evaluation_summary, flow, logs, model, node_runs. Use a comma-separated list to request multiple embeds. Protected: current_evaluation_summary requires evaluations:read.

​
pq
string | null

Pagination cursor query

​
from_prev
boolean
default:false

Backward pagination flag

Response

Paginated run list.

Paginated list response.

​
items
FullValidator · object[]
required
​
first
string | null
​
next
string | null
​
previous
string | null