---
title: "List run conditions"
method: GET
path: "/plugins/playbooks/api/v0/runs/{id}/conditions"
tags: ["Conditions"]
---

# List run conditions

`GET /plugins/playbooks/api/v0/runs/{id}/conditions`

Retrieve a paged list of conditions for a run. Run conditions are read-only snapshots copied from the playbook.

## Path parameters

- `id` string, required

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

A paged list of run conditions.

- ConditionList
  - `total_count` integer — The total number of conditions in the list, regardless of paging.
  - `page_count` integer — The total number of pages. This depends on the total number of conditions and the per_page parameter.
  - `has_more` boolean — A boolean describing whether there are more pages after the currently returned.
  - `items` Condition[] — The conditions in this page.
    - `id` string — A unique, 26 characters long, alphanumeric identifier for the condition.
    - `condition_expr` ConditionExprV1, required — A logical condition expression that can combine multiple conditions using AND/OR operators, or perform field comparisons using Is/IsNot operators.
      - `and` ConditionExprV1[] — Logical AND operation. All conditions in the array must be true.
      - `or` ConditionExprV1[] — Logical OR operation. At least one condition in the array must be true.
      - `is` ComparisonCondition
        - `field_id` string, required — The identifier of the field to compare against.
        - `value` string, required — The value to compare with. Format depends on the field type. Stored as JSON.
      - `isNot` ComparisonCondition
        - `field_id` string, required — The identifier of the field to compare against.
        - `value` string, required — The value to compare with. Format depends on the field type. Stored as JSON.
    - `version` integer, required — Version number of the condition expression format. Currently only version 1 is supported.
    - `playbook_id` string — The identifier of the playbook this condition belongs to.
    - `run_id` string — If this is a run condition (read-only snapshot), the identifier of the run. Empty for playbook conditions.
    - `create_at` integer — The condition creation timestamp, formatted as the number of milliseconds since the Unix epoch.
    - `update_at` integer — The condition update timestamp, formatted as the number of milliseconds since the Unix epoch.

## Other responses

- `403` — Access to the resource is forbidden for this user.
- `404` — Resource requested not found.
- `500` — There was an internal error in the server.

---

[API](https://skmtc.net/mattermost/apis/playbooks-api.md) · [All operations](https://skmtc.net/mattermost/apis/playbooks-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mattermost/playbooks-api/versions/3b509bbdf17e/schema)