> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dacard.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get benchmarks

> Read peer benchmarks for a cohort segment.

Read peer benchmarks for a cohort segment (e.g., Series-B SaaS, 30 to 100 employees). Returns p25, p50, p75 distributions per dimension. Used to render the "where you stand" comparison on score reports.

```bash theme={null}
curl -X GET https://app.dacard.ai/api/benchmarks/series_b_saas_30_100 \
  -H "Authorization: Bearer $DACARD_API_KEY"
```

| Property           | Value                    |
| ------------------ | ------------------------ |
| **Auth**           | Required                 |
| **Required scope** | Account membership       |
| **Idempotent**     | Yes (recomputed nightly) |

## Path

| Field        | Required | Notes                                                                   |
| ------------ | -------- | ----------------------------------------------------------------------- |
| `segmentKey` | yes      | The canonical segment key. Discoverable via `/api/assessment/metadata`. |

## Response

```json theme={null}
{
  "segmentKey": "series_b_saas_30_100",
  "dimensions": {
    "decision_quality": { "p25": 2.1, "p50": 3.2, "p75": 4.0, "n": 412 }
  },
  "computedAt": "2026-05-06T03:00:00Z"
}
```

## Errors

| Status | Code                       | When                                                     |
| ------ | -------------------------- | -------------------------------------------------------- |
| 401    | `AUTH_REQUIRED`            | No session.                                              |
| 404    | `Segment not found`        | Bad `segmentKey`.                                        |
| 422    | `Insufficient sample size` | Cohort has fewer than the minimum sample (currently 30). |
| 500    | `INTERNAL_ERROR`           | Read failed.                                             |