Skip to content

Server List Resource

List Object

A level list is a list of levels - playable objects in Geometry Dash.

A typical list server response is structured with a key:value:key:value pairing and is then split with a |

List Example Response

1:4788:2:Progression Level 1:3:R0QgQmVnaW5uZXJzIExpc3QgbGV2ZWwgMSEgR29vZCBsaXN0IG9mIGxldmVscyB0byBpbnRyb2R1Y2UgZnJpZW5kcyB0byB0aGUgZ2FtZSE=:5:5:49:6061424:50:tricipital:10:1451689:7:1:14:61715:19:1:51:90752263,59760047,88982532,78743788,88022936,89413344,90994090,74542823,74612523,55037478:55:20:56:5:28:1703050435:29:1703402400#15479163:tricipital:6061424#9999:0:10#f5da5823d94bbe7208dd83a30ff427c7d88fdb99

Each key is tied to a component within the client and the value sets data for the specific component. A list of all known keys can be found in the table below

List Structure

KeyName/ValueTypeDescription
1listIDIntegerThe id of the list
2listNameStringThe name of the list
3descriptionStringThe list description, encoded in base64
5versionIntegerThe version of the list published
7difficultyIntegerThe difficulty face for the list. -1 = N/A, 0 = Auto, 1 = Easy, 2 = Normal, 3 = Hard, 4 = Harder, 5 = Insane, 6 = Easy Demon, 7 = Medium Demon, 8 = Hard Demon, 9 = Insane Demon, 10 = Extreme Demon
10downloadsIntegerThe amount of times the list has been downloaded
14likesIntegerlikes - dislikes
19ratedBoolIf the list is rated or not
28uploadDateStringThe Unix timestamp of when the list was uploaded
29updateDateStringThe Unix timestamp of when the list was last updated
49accountIDIntegerThe account ID of the list author
50usernameStringThe username of the list author
51levelIDsComma-Separated ListAll level IDs in the list, separated by commas
55listRewardIntegerThe amount of diamonds awarded upon beating the required amount of levels in the list
56listRewardRequirementIntegerThe amount of levels needed to claim the list reward