---
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`

## Request

- Base URL: `http://localhost:8065/plugins/playbooks/api/v0`
- URL: `http://localhost:8065/plugins/playbooks/api/v0/plugins/playbooks/api/v0/runs/{id}/conditions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/mattermost/apis/playbooks-api/docs/plugins/playbooks/api/v0/runs/:id/conditions/get.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Changes

- **2025-10-13** `3b1944780f92`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mattermost/apis/playbooks-api/changes/plugins/playbooks/api/v0/runs/:id/conditions/get.md)

---

[API](https://skmtc.dev/mattermost/apis/playbooks-api.md) - [All operations](https://skmtc.dev/mattermost/apis/playbooks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mattermost/apis/playbooks-api/revisions/2acd884508c4?raw)