Retrieve Leaderboard (beta)

Retrieve leaderboard data.

Response schema is client/leaderboard-specific, we are working to finalize a common schema valid across different platforms and use cases.

• HABS leaderboard schema

Get full leaderboard

get

Retrieve the complete leaderboard for the specified leaderboard name. Returns the latest snapshot by default, or all historical snapshots if run_timestamp=all.

Path parameters

leaderboard_namestringRequired

Name of the leaderboard to retrieve

Query parameters

api_keystringRequired

API key for authentication

run_timestampstringOptional

Optional: 'all' to get all historical snapshots, omit for latest only

Responses

200

Successfully retrieved leaderboard data

application/json

401

Unauthorized - Invalid API key

404

Leaderboard not found or empty

422

Validation Error

application/json

500

Internal Server Error

get

/v1/leaderboard/{leaderboard_name}

HTTPcURLJavaScriptPython

GET /v1/leaderboard/{leaderboard_name}?api_key=text HTTP/1.1
Accept: */*

{
  "leaderboard_name": "text",
  "data": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "count": 1,
  "run_timestamp": "2026-02-05T00:03:03.334Z",
  "run_timestamps": [
    "2026-02-05T00:03:03.334Z"
  ]
}