# List Metrics

`GET /api/metric/list`

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

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

List active Metrics for the workspace resolved by your API key.

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

> [!TIP]
> This endpoint returns only Metrics. To list Policies, use [`/api/policy/list`](https://whitecircle.com/docs/latest/policy/list-policies.md).

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

- `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/metric/list' \
  --header "Authorization: Bearer $WHITECIRCLE_API_KEY" \
  --header 'whitecircle-version: 2026-06-01'
```

## Response

### 200

Success

`application/json`

- `id` (`string`, required)
- `name` (`string`, required)
- `rules` (`object[]`, required): Rules defining content to flag or allow. At least one rule contains `flagged_content`.
- `rules.id` (`string<uuid>`, required)
- `rules.flagged_content` (`string | null`, optional): Content that triggers a policy violation.
- `rules.allowed_content` (`string | null`, optional): Content that the policy must allow.
- `content_type` (`enum<string>`, required): Available options: `session`, `artifact`, `any`. Example: `"session"`.
- `event_selector_list` (`object[]`, required): Structured policy selector used by Events-aware policy matching.
- `event_selector_list.type` (`enum<string>`, required): Runtime surface selected by a policy for Events-aware matching. Available options: `message`, `tool`, `function`, `agent`, `artifact`, `reasoning`.
- `event_selector_list.field` (`string | null`, optional)
- `event_selector_list.kind` (`string | null`, optional)
- `role_list` (`enum<string>[]`, required): Role restriction used by the new policy targeting model. Empty role lists mean any role. Available options: `user`, `assistant`.
- `applies_to` (`enum<string>`, required): Available options: `input`, `output`, `any`. Example: `"input"`.
- `mode` (`enum<string>`, required): Available options: `prod`, `shadow`. Example: `"prod"`.
- `created_at` (`string<date-time>`, required)
- `state` (`enum<string>`, required): Available options: `active`, `inactive`, `draft`. Example: `"active"`.
- `country_codes` (`string[]`, required)
- `severity_level_id` (`string<uuid> | null`, optional)

**Example**

```json
[
  {
    "id": "01930000-0000-7000-8000-000000000001",
    "name": "No medical advice",
    "rules": [
      {
        "id": "01930000-0000-7000-8000-000000000010",
        "flagged_content": "Specific medical diagnoses or treatment recommendations"
      },
      {
        "id": "01930000-0000-7000-8000-000000000011",
        "allowed_content": "General wellness information and encouragement to consult a professional"
      }
    ],
    "content_type": "any",
    "event_selector_list": [],
    "role_list": [],
    "applies_to": "any",
    "mode": "prod",
    "created_at": "2026-06-01T12:00:00Z",
    "state": "active",
    "country_codes": []
  }
]
```

### 400

Bad Request
