---
title: "Read floored peer benchmarks"
method: GET
path: "/api/v1/benchmarks"
---

# Read floored peer benchmarks

`GET /api/v1/benchmarks`

## Request

- Base URL: `https://lvlupauto.com`
- URL: `https://lvlupauto.com/api/v1/benchmarks`
- Auth: HTTP bearer

Floored peer benchmarks (median + IQR) for the dealer's stack metrics. Answers the moat questions: 'how do I compare to peers my size?', 'am I above or below median on this metric?', 'what's my percentile?'. Every cohort figure is k>=5-anonymized; thin cohorts return cohort_suppressed=true with only your_value.

## Query parameters

- `vendor_id` string
- `metric_key` string
- `cohort` 'size' | 'state' | 'national'
- `period` 'monthly' | 'rolling-90d'

## Response `200`

Success

## Other responses

- `401`: Unauthorized — invalid or missing token
- `403`: Insufficient scope
- `422`: Validation error
- `429`: Rate limited or cap exceeded

---

[API](https://skmtc.dev/lvlupauto/apis/lvl-up-auto-headless-api.md) · [All operations](https://skmtc.dev/lvlupauto/apis/lvl-up-auto-headless-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lvlupauto/apis/lvl-up-auto-headless-api/revisions/805626b3a4ef?raw)