---
title: "Evaluate war history for current members of configured server clans"
method: POST
path: "/v2/roster/family/war-metrics/query"
tags: ["Roster Builder"]
---

# Evaluate war history for current members of configured server clans

`POST /v2/roster/family/war-metrics/query`

## Request

- Base URL: `https://api.clashk.ing`
- URL: `https://api.clashk.ing/v2/roster/family/war-metrics/query`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
- TypeScript: <https://skmtc.dev/clashk/apis/clashking-api/docs/v2/roster/family/war-metrics/query/post.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `server_id` string, required

## Request body

- object
  - `playerTags` string[], required
  - `metricId` 'war.hit_rate' | 'war.regular_hit_rate' | 'war.cwl_hit_rate' | 'war.hit_rate_confidence' | 'war.missed_attacks' | 'war.participation', required
  - `parameters` object

## Response `200`

Success

- object
  - `metricId` string, required
  - `parameters` object, required
  - `rows` object[], required
    - `playerTag` string, required
    - `value` unknown, required
    - `attackCount` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
  - `evaluatedAt` string, required

## Changes

- **2026-11-05** `f1874003a53d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/clashk/apis/clashking-api/changes/v2/roster/family/war-metrics/query/post.md)

---

[API](https://skmtc.dev/clashk/apis/clashking-api.md) - [All operations](https://skmtc.dev/clashk/apis/clashking-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clashk/apis/clashking-api/revisions/41ffee7f4263?raw)