{"_id":"570827dacc231e17009278e9","editedParams":true,"category":{"_id":"5705b12221cfed0e00e8c580","project":"56abbf55f25f160d00e17f4e","__v":0,"version":"56abbf55f25f160d00e17f51","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-04-07T01:00:18.230Z","from_sync":false,"order":4,"slug":"server-side-api","title":"Server Side API"},"project":"56abbf55f25f160d00e17f4e","editedParams2":true,"parentDoc":null,"version":{"_id":"56abbf55f25f160d00e17f51","project":"56abbf55f25f160d00e17f4e","__v":12,"createdAt":"2016-01-29T19:36:53.665Z","releaseDate":"2016-01-29T19:36:53.665Z","categories":["56abbf56f25f160d00e17f52","56abca6bf9757e0d007c6650","56acddfa0ab3c00d00ce3332","56af65da9d32e30d0006d30f","56af66cab34d210d003d9ad0","56af6afcd21e9c0d00b628d1","56af6d6ecc4cbd0d00ce2c88","5705b12221cfed0e00e8c580","570a5676ade45d0e00c1ad33","570d7d25d1e4b82000d9e385","570eac3c3160d10e0041df0e","575709000fd6a3200010dded"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"__v":0,"user":"56abbec30b9e0b0d00616274","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-04-08T21:51:22.200Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"name":"Retrieve Weekly Scores","code":"{\n  \"weekly_scores\": [\n    {\n      \"username\": \"EnglishDiaries\",\n      \"level\": 48,\n      \"score\": 2518,\n      \"avatar_url\": \"https://cdn1.kongcdn.com/user_avatars/0888/8221/x_dc78b392.jpg?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"Testing_1_2_3_\",\n      \"level\": 28,\n      \"score\": 2405,\n      \"avatar_url\": \"https://cdn3.kongcdn.com/assets/avatars/defaults/fluff.png?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"Pigjr1\",\n      \"level\": 52,\n      \"score\": 1745,\n      \"avatar_url\": \"https://cdn2.kongcdn.com/user_avatars/0155/1906/Pig.png?i10c=img.resize(width:28)\"\n    }\n  ],\n  \"page_count\": 1,\n  \"per_page\": 25,\n  \"success\": true\n}","language":"json","status":200},{"name":"Retrieve Lifetime Scores","code":"{\n  \"lifetime_scores\": [\n    {\n      \"username\": \"Sens3\",\n      \"level\": 41,\n      \"score\": 4898,\n      \"avatar_url\": \"https://cdn2.kongcdn.com/user_avatars/0089/5543/soul_reaper.jpg?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"kuchi666\",\n      \"level\": 28,\n      \"score\": 4836,\n      \"avatar_url\": \"https://cdn3.kongcdn.com/assets/avatars/defaults/fluff.png?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"luk4sq\",\n      \"level\": 52,\n      \"score\": 4795,\n      \"avatar_url\": \"https://cdn4.kongcdn.com/user_avatars/0026/0050/avatar-two-face.jpg?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"Sellyme\",\n      \"level\": 56,\n      \"score\": 4752,\n      \"avatar_url\": \"https://cdn1.kongcdn.com/user_avatars/0007/6811/B78dU.png?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"Nerava\",\n      \"level\": 48,\n      \"score\": 4584,\n      \"avatar_url\": \"https://cdn2.kongcdn.com/user_avatars/0033/3252/Nerava_Icon.png?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"metallica69\",\n      \"level\": 13,\n      \"score\": 4478,\n      \"avatar_url\": \"https://cdn2.kongcdn.com/user_avatars/0023/5456/Steven.jpg?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"goosefish\",\n      \"level\": 17,\n      \"score\": 4411,\n      \"avatar_url\": \"https://cdn2.kongcdn.com/user_avatars/0115/2814/1272563788.8214335108.png?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"TDMazeMaster\",\n      \"level\": 22,\n      \"score\": 4050,\n      \"avatar_url\": \"https://cdn2.kongcdn.com/user_avatars/0014/2206/face.jpg?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"MidgetMan\",\n      \"level\": 65,\n      \"score\": 3992,\n      \"avatar_url\": \"https://cdn2.kongcdn.com/user_avatars/0003/8272/ProfGintoki.jpg?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"BestMte\",\n      \"level\": 65,\n      \"score\": 3820,\n      \"avatar_url\": \"https://cdn2.kongcdn.com/user_avatars/0152/1974/Lonely.jpg?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"AGW_IS_FAKE\",\n      \"level\": 62,\n      \"score\": 3808,\n      \"avatar_url\": \"https://cdn3.kongcdn.com/user_avatars/0055/4579/avm_avatar_alien_lurker.jpg?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"jamesbean9\",\n      \"level\": 30,\n      \"score\": 3806,\n      \"avatar_url\": \"https://cdn4.kongcdn.com/user_avatars/0121/6259/Blue_Green_Flames_by_evilblackdragon12.jpg?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"Pandorite\",\n      \"level\": 41,\n      \"score\": 3744,\n      \"avatar_url\": \"https://cdn4.kongcdn.com/user_avatars/0008/6524/nes_ms_pac_man_ghost-copy1225379243.jpg?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"BenV\",\n      \"level\": 40,\n      \"score\": 3698,\n      \"avatar_url\": \"https://cdn1.kongcdn.com/user_avatars/0000/0765/starbuckbig.png?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"coreyog\",\n      \"level\": 10,\n      \"score\": 3652,\n      \"avatar_url\": \"https://cdn1.kongcdn.com/assets/avatars/defaults/darkness.png?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"Yukidaruma\",\n      \"level\": 65,\n      \"score\": 3650,\n      \"avatar_url\": \"https://cdn3.kongcdn.com/user_avatars/0055/6052/666-satan-1963987.jpg?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"y0ttabyte\",\n      \"level\": 65,\n      \"score\": 3618,\n      \"avatar_url\": \"https://cdn4.kongcdn.com/user_avatars/0018/5263/aged_wb20131201063656632994.jpg?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"Ehlmo\",\n      \"level\": 62,\n      \"score\": 3604,\n      \"avatar_url\": \"https://cdn2.kongcdn.com/user_avatars/0031/2266/sparta.jpg?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"ravenhawk82\",\n      \"level\": 22,\n      \"score\": 3603,\n      \"avatar_url\": \"https://cdn2.kongcdn.com/user_avatars/0066/9657/avatar_atlas3.png?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"goodrich\",\n      \"level\": 32,\n      \"score\": 3593,\n      \"avatar_url\": \"https://cdn1.kongcdn.com/user_avatars/0007/1665/champloo02_1600.jpg?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"SeargX\",\n      \"level\": 28,\n      \"score\": 3589,\n      \"avatar_url\": \"https://cdn3.kongcdn.com/user_avatars/0059/4076/Gmod_MSN2.jpg?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"Angelow\",\n      \"level\": 38,\n      \"score\": 3588,\n      \"avatar_url\": \"https://cdn4.kongcdn.com/user_avatars/0122/4524/1417469722.92521249311.png?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"dna0008\",\n      \"level\": 65,\n      \"score\": 3575,\n      \"avatar_url\": \"https://cdn4.kongcdn.com/user_avatars/0110/4720/7.png?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"Mongatard\",\n      \"level\": 24,\n      \"score\": 3574,\n      \"avatar_url\": \"https://cdn3.kongcdn.com/assets/avatars/defaults/robotboy.png?i10c=img.resize(width:28)\"\n    },\n    {\n      \"username\": \"CaioFreitas\",\n      \"level\": 55,\n      \"score\": 3574,\n      \"avatar_url\": \"https://cdn2.kongcdn.com/user_avatars/0008/8051/shelby.jpg?i10c=img.resize(width:28)\"\n    }\n  ],\n  \"page_count\": 5,\n  \"per_page\": 25,\n  \"success\": true\n}","language":"json","status":200}]},"settings":"5707e879cfc0992200c2a419","examples":{"codes":[{"code":"curl -XGET 'https://api.kongregate.com/api/high_scores/weekly/22544.json'","language":"curl","name":"Retrieve Weekly Scores"},{"name":"Retrieve Lifetime Scores","code":"curl -XGET 'https://api.kongregate.com/api/high_scores/lifetime/22544.json'","language":"curl"}]},"method":"get","auth":"required","params":[{"_id":"570827dacc231e17009278eb","ref":"","in":"path","required":true,"desc":"daily, weekly, or lifetime","default":"","type":"string","name":"scope"},{"_id":"570827dacc231e17009278ea","ref":"","in":"path","required":true,"desc":"Statistic ID to retrieve scores for","default":"","type":"int","name":"statistic_id"}],"url":"/high_scores/:scope/:statistic_id.json"},"isReference":true,"order":6,"body":"[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Note\",\n  \"body\": \"You can find statistic IDs for your game on the \\\"edit statistics\\\" page\"\n}\n[/block]","excerpt":"Retrieve high scores for a statistic","slug":"server-api-high-scores","type":"endpoint","title":"High Scores"}

getHigh Scores

Retrieve high scores for a statistic

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

scope:
required
string
daily, weekly, or lifetime
statistic_id:
required
integer
Statistic ID to retrieve scores for

Examples


Result Format


Documentation

[block:callout] { "type": "info", "title": "Note", "body": "You can find statistic IDs for your game on the \"edit statistics\" page" } [/block]

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}