---
title: "List Workflow"
method: GET
path: "/workflow/workflows"
tags: ["workflows"]
---

# List Workflow

`GET /workflow/workflows`

## Request

- Base URL: `https://api.anyreach.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.anyreach.ai/workflow/workflows`
- Auth: HTTP bearer

List workflows.

Offset mode reads api.workflows_index with sort, filters, search and
labels. `offset` selects it, as does any of sort, dir, search, labels,
live, published, has_trigger, trigger_status, created_by, modified_by or
last_run_after/before. The first page (offset 0) carries the match count
in `pagination.total` and the X-Total-Count header, and
`pagination.offset` is the next page's offset (null on the last page).

Otherwise, and whenever `cursor` or `ids` is given, it is the original
list ordered by created_at: follow `pagination.next_cursor` until it is
null.

## Query parameters

- `ids` string, nullable: Comma-separated workflow ids to fetch (e.g. recently accessed), at most 50. Selects cursor mode.
- `offset` integer, nullable: Offset of the first row. Selects offset mode.
- `limit` integer: Limit the number of workflows returned
- `cursor` string, nullable: Cursor for pagination. Selects cursor mode.
- `sort` string, nullable: Sort by name, created_at, updated_at, created_by, modified_by, total_runs, last_run, live, published or label:<key>. Default created_at.
- `dir` string, nullable: asc or desc (default desc)
- `search` string, nullable: Case-insensitive match on the workflow name
- `name` string, nullable: Filter workflows by name (in offset mode, an alias of search)
- `labels` string, nullable: JSON object of label filters: {"key": "value"}, {"key": ["any", "of"]} or {"key": null} for "not set"
- `live` boolean, nullable: Has a live version
- `published` boolean, nullable: Has a published version
- `has_trigger` boolean, nullable: The published (else latest) version has a trigger
- `trigger_status` string, nullable: Comma-separated subset of active, testing, inactive
- `created_by` string, nullable: Creator actor
- `modified_by` string, nullable: Last modifier actor
- `created_after` string, date-time, nullable: Filter workflows created after this datetime
- `created_before` string, date-time, nullable: Filter workflows created before this datetime
- `updated_after` string, date-time, nullable: Filter workflows updated after this datetime
- `updated_before` string, date-time, nullable: Filter workflows updated before this datetime
- `last_run_after` string, date-time, nullable: Filter workflows last run after this datetime
- `last_run_before` string, date-time, nullable: Filter workflows last run before this datetime

## Headers

- `x-anyreach-org` string, nullable: Organization ID for user PATs (pat_ prefix tokens)

## Response `200`

Successful Response

- PaginatedWorkflowResponse
  - `data` WorkflowSchema[], required
    - `id` string, uuid, required
    - `name` string, required
    - `organization_id` string, required
    - `description` string, nullable
    - `is_public` boolean
    - `versions` SimpleWorkflowVersionResponse[], nullable
      - `id` string, required
      - `version` integer, required
      - `is_published` boolean, required
      - `is_live` boolean, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `created_by` string, nullable
    - `modified_by` string, nullable
    - `total_runs` integer, nullable
    - `today_runs` integer, nullable
    - `daily_run_counts` integer[], nullable
    - `last_run_date` string, nullable
    - `step_count` integer, nullable
    - `has_trigger` boolean, nullable
    - `trigger_status` string, nullable
    - `labels` object
  - `pagination` RoutesWorkflowModelsCommonPaginationMeta, required
    - `limit` integer, required
    - `next_cursor` string, nullable
    - `total` integer, nullable
    - `offset` integer, nullable

## Other responses

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

---

[API](https://skmtc.dev/anyreach/apis/anyreach-api.md) - [All operations](https://skmtc.dev/anyreach/apis/anyreach-api/llms.txt) - [OpenAPI document](https://skmtc.dev/anyreach/apis/anyreach-api/revisions/2eddf40c8c93?raw)