Get a leaderboard (global, zone, or contest)
Parameters depend on scope:
- global —
type(credits|accuracy|volume, default credits),period(all|monthly|weekly, default all),limit. Top-N only:next_cursoris alwaysnull. - zone —
id(zone slug, required),month(YYYY-MM, default current month),cursor/limit. - contest —
round(optional),cursor/limit.
Authorizations
Personal API key issued per SeeSaw user account:
Authorization: Bearer sspat_…. Manage keys on the app API
(/v1/users/me/api-keys). Revocation propagates within ~60 seconds
(validation cache window).
Path Parameters
global, zone, contest Query Parameters
scope=global: ranking dimension
credits, accuracy, volume scope=global: time window
all, monthly, weekly scope=zone: zone slug (required)
scope=zone: month like 2026-07 (default: current month)
^\d{4}-\d{2}$scope=contest: round filter (omit for the overall board)
Opaque pagination cursor from a previous response's next_cursor.
Page size (max 100).
1 <= x <= 100Response
The leaderboard with its query context echoed back
Self-describing envelope — context echoes the resolved query so agents can cite what board they are looking at.