# List Workflow Runs

> List recent runs of a workflow with their results

- **URL**: https://orshot.com/docs/api-reference/workflow-runs-list

---

## Overview

Returns a workflow's recent runs, newest first, with row counts and credits used per run.```markdown tab="Endpoint"
https://api.orshot.com/v1/workflows/:id/runs
```## Path Parameters

| Parameter | Type    | Required | Description                   |
| --------- | ------- | -------- | ----------------------------- |
| `id`      | Integer | Yes      | The unique ID of the workflow |

## Query Parameters

| Parameter | Type    | Required | Description                                 |
| --------- | ------- | -------- | ------------------------------------------- |
| `limit`   | Integer | No       | Results to return, 1 to 100. Defaults to 20 |

## Request```js
await fetch("https://api.orshot.com/v1/workflows/44/runs?limit=10", {
  method: "GET",
  headers: {
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});
```</Tab>```json
{
  "runs": [
    {
      "id": 5121,
      "status": "success",
      "trigger_type": "manual",
      "rows_total": 3,
      "rows_succeeded": 3,
      "rows_failed": 0,
      "rows_skipped": 0,
      "automation_credits_used": 1,
      "render_credits_used": 3,
      "error": null,
      "created_at": "2026-07-11T08:00:00.000Z",
      "started_at": "2026-07-11T08:00:01.204Z",
      "finished_at": "2026-07-11T08:00:14.879Z"
    }
  ]
}
```</Tab>
</Tabs>

## Run Statuses

| Status    | Meaning                                            |
| --------- | -------------------------------------------------- |
| `queued`  | Waiting to be picked up                            |
| `running` | Currently executing                                |
| `success` | Every row succeeded                                |
| `partial` | Some rows succeeded, some failed                   |
| `failed`  | The run produced nothing                           |
| `skipped` | Nothing to do (for example, an empty poll)         |
| `cancelled` | The run was cancelled before finishing           |

## Error Responses

### Workflow Not Found (404)```json
{
  "error": "Not found"
}
```## Rate Limits

- 60 requests per minute per workspace