Rankora API Quick Start
Base URL
text
https://api.rankora.dev/api/v1Create or Update Entry
Add a new leaderboard entry or update an existing one by sending a POST request to:
http
POST /leaderboard/entries
Authorization: Bearer YOUR_API_KEY_HERE
Content-Type: application/json
{
"name": "PlayerOne",
"score": 12345,
"player_id": "optional-player-id",
// metadata only avaliable on Indie or higher plans
"metadata": {
"key1": "value1"
}
}json
{
"success": true,
"player_id": "player-id",
}Get Leaderboard Entries
Retrieve top leaderboard entries with optional pagination using:
http
GET /leaderboard/entries?limit=10&offset=0&order=desc
Authorization: Bearer YOUR_API_KEY_HEREResponse Bodyjson
{
"entries": [
{ "name": "PlayerOne", "score": 9500, "created_at": "2025-07-14T19:19:40.956582+00:00", "updated_at": "2025-07-21T19:22:47.782875+00:00", "metadata": null },
{ "name": "PlayerTwo", "score": 8750, "created_at": "2025-07-14T18:45:22.123456+00:00", "updated_at": "2025-07-21T12:12:41.623156+00:00", "metadata": { "other": "value" } }
],
"pagination": { "limit": 10, "offset": 0, "total": 156 }
}