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

# List Workflow Ids

`GET /workflow/workflows/ids`

## 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/ids`
- Auth: HTTP bearer

Ids of every workflow matching the list's filters, in list order, paged.

`total` is the full match count, so a caller can page until it has them
all (select-all across pages).

## Query parameters

- `offset` integer: Offset of the first id
- `limit` integer: Number of ids to return
- `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

- IdsPage
  - `ids` string[], required
  - `total` integer, required

## 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)