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

# List run history

`POST /runs/history`

Returns paginated historic runs for the caller's user. Use POST /runs for recent (non-archived) runs.

## Request body

- RunHistoricRunsRequest
  - `end_date` string, date-time, required
  - `limit` integer, required
  - `offset` integer, required
  - `search` string
  - `start_date` string, date-time, required
  - `status_filter` string[], nullable
  - `workflow_id` string

## Response `200`

OK

- RunHistoricRunsResponse
  - `limit` integer, required
  - `offset` integer, required
  - `runs` RunHistoricRun[], nullable, required
    - `cancelled_at` string
    - `completed_at` string
    - `created_at` string
    - `error_message` string
    - `org_id` string
    - `phone_id` string
    - `run_id` string, required
    - `run_metadata` string
    - `started_at` string
    - `status` string, required
    - `success` boolean
    - `trigger` string, required
    - `user_id` string, required
    - `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/versions/d7ecf9466d6d/schema)