# Get Metric

`GET /api/metric/get_by_id`

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)

Get a single metric by ID.

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

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

- `id` (`string`, required)

## Request example

```bash
curl --request GET \
  --url 'https://eu.whitecircle.com/api/metric/get_by_id?id=<id>' \
  --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
