---
title: "Get Workflow Runs"
method: GET
path: "/api/v1/workflow/{workflow_id}/runs"
tags: ["main"]
---

# Get Workflow Runs

`GET /api/v1/workflow/{workflow_id}/runs`

Get workflow runs with optional filtering and sorting.

Filters should be provided as a JSON-encoded array of filter criteria.
Example: [{"attribute": "dateRange", "value": {"from": "2024-01-01", "to": "2024-01-31"}}]

## Path parameters

- `workflow_id` integer, required

## Query parameters

- `page` integer — Page number (starts from 1)
- `limit` integer — Number of items per page
- `filters` string, nullable — JSON-encoded filter criteria
- `sort_by` string, nullable — Field to sort by (e.g., 'duration', 'created_at')
- `sort_order` string, nullable — Sort order ('asc' or 'desc')

## Headers

- `authorization` string, nullable
- `X-API-Key` string, nullable

## Response `200`

Successful Response

- WorkflowRunsResponse
  - `runs` WorkflowRunResponseSchema[], required
    - `id` integer, required
    - `workflow_id` integer, required
    - `name` string, required
    - `mode` string, required
    - `created_at` string, date-time, required
    - `is_completed` boolean, required
    - `transcript_url` string, nullable, required
    - `recording_url` string, nullable, required
    - `user_recording_url` string, nullable
    - `bot_recording_url` string, nullable
    - `transcript_public_url` string, nullable
    - `recording_public_url` string, nullable
    - `user_recording_public_url` string, nullable
    - `bot_recording_public_url` string, nullable
    - `public_access_token` string, nullable
    - `cost_info` object, nullable, required
    - `usage_info` object, nullable
    - `definition_id` integer, nullable, required
    - `initial_context` object, nullable
    - `gathered_context` object, nullable
    - `call_type` 'inbound' | 'outbound', required
    - `logs` object, nullable
    - `annotations` object, nullable
  - `total_count` integer, required
  - `page` integer, required
  - `limit` integer, required
  - `total_pages` integer, required
  - `applied_filters` object[], nullable

## Other responses

- `404` — Not found
- `422` — Validation Error

---

[API](https://skmtc.dev/dograh/apis/dograh-api.md) · [All operations](https://skmtc.dev/dograh/apis/dograh-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dograh/dograh-api/revisions/e7d045c0295a/schema)