---
title: "List runs"
method: POST
path: "/runs"
tags: ["Runs"]
---

# List runs

`POST /runs`

Returns paginated recent runs for the caller's org. Filters: workflow, search text, status, trigger; sort by any of the columns listed in RunSortField.

## Request body

- RunRunListRequest
  - `limit` integer, required
  - `offset` integer, required
  - `search` string
  - `sort_by` RunRunSortSpec[], nullable
    - `field` string, required
    - `order` string, required
  - `status_filter` string[], nullable
  - `trigger_filter` string[], nullable
  - `workflow_id` string

## Response `200`

OK

- RunRunListResponse
  - `limit` integer, required
  - `offset` integer, required
  - `runs` RunRunResponse[], nullable, required
    - `cancelled_at` string, date-time
    - `completed_at` string, date-time
    - `create_date` string, date-time, required
    - `error_message` string
    - `id` string, required
    - `logs` string
    - `phone_id` string
    - `run_metadata` object
    - `schedule_timeout_seconds` integer
    - `session_id` string
    - `started_at` string, date-time
    - `status` string, required
    - `success` boolean
    - `trace_expired_at` string, date-time
    - `trigger` string, required
    - `update_date` string, date-time, required
    - `user_id` string, required
    - `variables` object
    - `video_url` string
    - `workflow_id` string, required
  - `total` integer, required

## Other responses

- `default` — Error

---

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