# List Conditions

`GET /api/condition/list`

Base URLs: `https://eu.whitecircle.com`, `https://us.whitecircle.com`

OpenAPI: [latest/openapi.json](https://whitecircle.com/docs/latest/openapi.json)

List Conditions for the workspace resolved by your API key.

> [!NOTE]
> This endpoint is available only in API version `2026-06-01`. Send the `whitecircle-version: 2026-06-01` header on every request.

Filter results with `environment_id` or `state` (`Active`, `Inactive`, or `Draft`). Each result includes the current Condition revision, `environment_ids`, `policy_ids`, and `metric_ids`. The default state is `Active`.

## Authorizations

- `Authorization` (`string`, header, required): API Key required. Format: Bearer wc-your-api-key.

## Headers

- `whitecircle-version` (`string`, required): API Version. Example: `"2026-06-01"`.

## Query Parameters

- `environment_id` (`string | null`, optional)
- `state` (`null | enum<string>`, optional): Available options: `Active`, `Inactive`, `Draft`.

## Request example

```bash
curl --request GET \
  --url 'https://eu.whitecircle.com/api/condition/list' \
  --header "Authorization: Bearer $WHITECIRCLE_API_KEY" \
  --header 'whitecircle-version: 2026-06-01'
```

## Response

### 200

Success

`application/json`

- `id` (`string<uuid>`, required)
- `revision_id` (`string<uuid>`, required)
- `name` (`string`, required)
- `description` (`string`, required)
- `conditions` (`any`, required)
- `state` (`enum<string>`, required): Available options: `Active`, `Inactive`, `Draft`.
- `created_at` (`string<date-time>`, required)
- `updated_at` (`string<date-time>`, required)
- `environment_ids` (`string[]`, required)
- `policy_ids` (`string[]`, required)
- `metric_ids` (`string[]`, required)

**Example**

```json
[
  {
    "conditions": {
      "conditions": [
        {
          "field": "user.region",
          "operator": "eq",
          "type": "condition",
          "value": "eu"
        }
      ],
      "op": "and",
      "type": "group"
    },
    "created_at": "2026-06-01T12:00:00Z",
    "description": "Applies stricter Policies to users in the EU",
    "environment_ids": [
      "117b391d-569a-4b55-8241-9f172b17a63d"
    ],
    "id": "019f0000-0000-7000-8000-000000000001",
    "metric_ids": [
      "6c0710ea-d669-49b9-9465-e52aebf95b66"
    ],
    "name": "EU users",
    "policy_ids": [
      "70289e06-9111-463e-b121-7247c2b7bfbd"
    ],
    "revision_id": "019f0000-0000-7000-8000-0000000000f1",
    "state": "Active",
    "updated_at": "2026-06-01T12:00:00Z"
  }
]
```

### 400

Bad Request
