---
title: "Compare this swarm with similar swarms"
method: GET
path: "/api/fleet-benchmark"
tags: ["Telemetry"]
---

# Compare this swarm with similar swarms

`GET /api/fleet-benchmark`

## Request

- Base URL: `http://localhost:3013`
- URL: `http://localhost:3013/api/fleet-benchmark`
- Auth: HTTP bearer

Compares local task volume and success rate with fleet percentiles over the last 30 days. Comparisons require telemetry, an organization name, and a known proxy ingest date. A website, team size, and use case enable full comparisons with peer filters. The response includes the proxy's peer group when available. With telemetry off, it returns local DB counts without a proxy request. The fleet cache key includes the peer filters.

## Response `200`

Benchmark, or the reason it is not shown

- object
  - `state` 'ready' | 'telemetry_off' | 'no_org_name' | 'not_enough_tasks' | 'unavailable', required
  - `level` 'basic' | 'full', required
  - `peerGroup` object, nullable, required
    - `teamSize` string, nullable, required
    - `useCase` string, nullable, required
    - `orgs` integer, required
  - `local` object, nullable, required
    - `tasksPerWeek` number, required
    - `taskSuccessRate` number, nullable, required
    - `finishedTasks` integer, required
    - `agents` integer, required
    - `bucket` '1' | '2-5' | '6+' | 'null', nullable, required
  - `minFinishedTasks` integer, required
  - `generatedAt` string, nullable, required
  - `comparisons` object[], required
    - `key` 'tasksPerWeek' | 'taskSuccessRate', required
    - `value` number, required
    - `p50` number, required
    - `band` 'top_10' | 'top_25' | 'above_median' | 'below_median' | 'bottom_25', required
    - `peers` '1' | '2-5' | '6+' | 'all', required
    - `installs` integer, required

## Other responses

- `401`: Unauthorized
- `403`: Guest page sessions cannot read the benchmark

## Changes

- **2026-10-19** `f6ab201accbf`: 2 info
  - added the required property `level` to the response with the `200` status
  - added the required property `peerGroup` to the response with the `200` status
- **2026-10-12** `4096a267550c`: 1 info
  - endpoint added
- **2026-10-12** `90c376f780df`: 1 breaking
  - api path removed without deprecation
- **2026-10-12** `9ea4863df376`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/fleet-benchmark/get.md)

---

[API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) - [All operations](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/revisions/7e4c7198192a?raw)