Read-only data API
Build a new view
of the community.
Use versioned catalog, snapshot, distribution, and history data in a visualizer of your own. The public API intentionally has no write operations.
Quickstart
Public leaderboard responses are cached and can be fetched without a key during development.
curl https://tier-bench.calgarypermit.ca/api/v1/leaderboards/overall
Endpoints
GET /api/v1/leaderboards
GET /api/v1/leaderboards/{slug}
GET /api/v1/models
GET /api/v1/models/{id}/history
Data contract
- All identifiers are opaque strings; never infer a vendor from an ID.
- Dates use ISO 8601 UTC.
- Leaderboard payloads include an algorithm version.
- Cache responses for at least five minutes and send tier-bench attribution.
- API v1 exposes GET only and its database path is read-only by design.
{
"data": {
"category": "overall",
"algorithm_version": "1.0",
"models": [{ "rank": 1, "score": 5.24, "voters": 842 }]
}
}
Keys and quotas
Developer keys
Keys identify your app and carry read quotas. They can never modify tier-bench data.