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.
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.
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
{
"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. |
