---
title: "Describe capability benchmarks"
method: GET
path: "/v1/capabilities/{capability_key}/benchmarks"
tags: ["public_api", "external"]
---

# Describe capability benchmarks

`GET /v1/capabilities/{capability_key}/benchmarks`

## Request

- Base URL: `https://api.hydracept.com`
- URL: `https://api.hydracept.com/v1/capabilities/{capability_key}/benchmarks`
- Auth: none required

Benchmark definition and coverage. Comparative scores are not computed in this release.

## Path parameters

- `capability_key` string, required

## Response `200`

Successful response

- CapabilityBenchmarkDiscoveryResponse
  - `capability` string, required
  - `policyVersion` string, nullable
  - `coverageStatus` string, nullable
  - `benchmarkPolicyId` string, nullable
  - `workloadProfileId` string, nullable
  - `derivedScoreHash` string, nullable
  - `routingProfiles` object[]
  - `targets` object[]

## Other responses

- `404`: Structured public error envelope (`code`, `message`, `requestId`, …)
- `422`: Validation failure: public envelope plus Pydantic `detail` / `validationErrors`
- `429`: Structured public error envelope (`code`, `message`, `requestId`, …)
- `500`: Structured public error envelope (`code`, `message`, `requestId`, …)
- `502`: Structured public error envelope (`code`, `message`, `requestId`, …)
- `503`: Structured public error envelope (`code`, `message`, `requestId`, …)

---

[API](https://skmtc.dev/hydracept/apis/hydracept-public-api.md) · [All operations](https://skmtc.dev/hydracept/apis/hydracept-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hydracept/apis/hydracept-public-api/revisions/2d41a8069ede?raw)