# List Policies

`GET /api/policy/list`

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

OpenAPI: [2026-04-15/openapi.json](https://whitecircle.com/docs/2026-04-15/openapi.json)

List active policies for the team resolved by your API key.

> [!NOTE]
> This endpoint is available only for API version `2026-04-15`. Send `whitecircle-version: 2026-04-15`.

> [!TIP]
> This endpoint returns only policies. To list metrics, use [`/api/metric/list`](https://whitecircle.com/docs/2026-04-15/metric/list-metrics.md).

## Authorizations

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

## Headers

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

## Query Parameters

- `deployment_id` (`string | null`, optional)
- `content_type` (`null | enum<string>`, optional): Available options: `session`, `artifact`, `any`. Example: `"session"`.
- `applies_to` (`null | enum<string>`, optional): Available options: `input`, `output`, `any`. Example: `"input"`.
- `mode` (`null | enum<string>`, optional): Available options: `prod`, `shadow`. Example: `"prod"`.

## Request example

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

## Response

### 200

Success

`application/json`

- `id` (`string`, required)
- `name` (`string`, required)
- `flagged_content` (`string`, required)
- `applies_to` (`enum<string>`, required): Available options: `input`, `output`, `any`. Example: `"input"`.
- `content_type` (`enum<string>`, required): Available options: `session`, `artifact`, `any`. Example: `"session"`.
- `mode` (`enum<string>`, required): Available options: `prod`, `shadow`. Example: `"prod"`.
- `deployment_ids` (`string[]`, required)
- `country_codes` (`string[]`, required)
- `rollout_percentage` (`integer<int32>`, required): Required range: `x >= 0`.
- `revision_id` (`string`, required)
- `created_at` (`string<date-time>`, required)
- `allowed_content` (`string | null`, optional)
- `severity_level_id` (`string<uuid> | null`, optional)
- `deleted_at` (`string<date-time> | null`, optional)

**Example**

```json
[
  {
    "id": "<string>",
    "name": "<string>",
    "flagged_content": "<string>",
    "applies_to": "input",
    "content_type": "session",
    "mode": "prod",
    "deployment_ids": [
      "<string>"
    ],
    "country_codes": [
      "<string>"
    ],
    "rollout_percentage": 123,
    "revision_id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "allowed_content": "<string>",
    "severity_level_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "deleted_at": "2023-11-07T05:31:56Z"
  }
]
```

### 400

Bad Request
