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

# List workflows

`GET /workflows`

Paginated list of workflows in the caller's org, with optional search, status, platform, and created/last-run date filters via query params.

## Query parameters

- `limit` integer
- `offset` integer
- `search` string — free-text search across workflow name or ID substring
- `status` string[], nullable — filter by workflow status (lowercase)
- `platform` string[], nullable — filter by device platform (lowercase)
- `created_after` string — only workflows created at/after this RFC3339 time
- `created_before` string — only workflows created at/before this RFC3339 time
- `last_run_after` string — only workflows last run at/after this RFC3339 time
- `last_run_before` string — only workflows last run at/before this RFC3339 time

## Response `200`

OK

- WorkflowListResponse — Paginated list of workflows.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `limit` integer, required — Page size used for this response.
  - `offset` integer, required — Pagination offset used for this response.
  - `total` integer, required — Total number of workflows matching the query.
  - `workflows` WorkflowResponse[], nullable, required — Page of workflow records with stats.
    - `$schema` string, uri — A URL to the JSON Schema for this object.
    - `stats` WorkflowStats, required — WorkflowStats summarizes run statistics for a workflow.
      - `success_rate` number, double, required — Fraction of runs that completed successfully, from 0.0 to 1.0 (multiply by 100 for a percentage).
      - `total_runs` integer, required — Total number of runs for this workflow.
    - `workflow` WorkflowSummary, required — A workflow: a saved automation that runs against a phone.
      - `capture` boolean, required — Whether this workflow's runs capture media into the org's file library (default true).
      - `created_at` string, date-time, required — When the workflow was created.
      - `id` string, uuid, required — Workflow identifier.
      - `last_run_at` string, date-time, nullable, required — When the workflow last ran; absent if never run.
      - `name` string, required — Workflow name.
      - `ocr_engine` 'free' | 'premium', required — OCR engine the workflow runs with.
      - `organization_id` string, uuid, nullable, required — Organization the workflow belongs to.
      - `platform` 'android' | 'ios' | 'both', required — Target platform.
      - `recording` boolean, required — Whether this workflow's runs record their screen (default true).
      - `status` 'ready' | 'training' | 'running', required — Workflow lifecycle status.
      - `telemetry` boolean, required — Whether this workflow's runs persist telemetry spans (default true).
      - `updated_at` string, date-time, required — When the workflow was last updated.
      - `user_id` string, uuid, required — User who created the workflow.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/axilioai/apis/axilio-api.md) · [All operations](https://skmtc.net/axilioai/apis/axilio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/axilioai/axilio-api/versions/108ab4b41051/schema)