# List Workflows

> List all workflows in your workspace

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

---

## Overview

Returns your workspace's workflows, newest first. Steps are omitted from list responses to keep them light; fetch a single workflow to get its full steps.```markdown tab="Endpoint"
https://api.orshot.com/v1/workflows
```## Query Parameters

| Parameter | Type    | Required | Description                                                  |
| --------- | ------- | -------- | ------------------------------------------------------------ |
| `status`  | String  | No       | Filter by status: `draft`, `active`, `paused` or `archived`   |
| `limit`   | Integer | No       | Results per page, 1 to 200. Defaults to 50                    |
| `offset`  | Integer | No       | Number of results to skip. Defaults to 0                      |

## Request```js
await fetch("https://api.orshot.com/v1/workflows?status=active&limit=20", {
  method: "GET",
  headers: {
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});
```</Tab>```json
{
  "workflows": [
    {
      "id": 44,
      "name": "Renders from Google Sheets",
      "description": "Render a card for every new row",
      "status": "active",
      "trigger_type": "google_sheets_new_row",
      "next_run_at": "2026-07-11T09:00:00.000Z",
      "run_count": 128,
      "success_count": 126,
      "last_run_at": "2026-07-11T08:00:03.412Z",
      "last_status": "success",
      "required_connections": ["google"],
      "template_ref": null,
      "attribution": {},
      "is_shared": false,
      "share_slug": null,
      "created_at": "2026-06-20T11:24:09.551Z",
      "updated_at": "2026-07-11T08:00:04.101Z"
    }
  ]
}
```</Tab>
</Tabs>

## Error Responses

### Enterprise Access Required (403)```json
{
  "error": "Access Forbidden: Enterprise API feature 'workflows' is not enabled for your plan. Contact hi@orshot.com for Enterprise access",
  "code": "enterprise_required"
}
```## Rate Limits

- 60 requests per minute per workspace