Skip to main content
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"
PropertyValue
AuthRequired
Required scopeAccount membership
IdempotentYes (recomputed nightly)

​
Path

FieldRequiredNotes
segmentKeyyesThe 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

StatusCodeWhen
401AUTH_REQUIREDNo session.
404Segment not foundBad segmentKey.
422Insufficient sample sizeCohort has fewer than the minimum sample (currently 30).
500INTERNAL_ERRORRead failed.