From ARK: Survival Evolved Wiki
Jump to: navigation, search

ARK's Web API is used by the client to get a list of official servers and display news. Each endpoint can be accessed by sending a simple HTTP GET request. HTTPS is not supported. Some endpoints are suffixed by a ".ini" extension, but their content is not in the format of an INI file. Endpoint names are case sensitive. All API endpoints are hosted on the official ARK server at arkdedicated.com.

version[edit | edit source]

Returns the current latest game version as a simple string. Example: the URL http://arkdedicated.com/version returns 326.13 for game version of 326.13.

version/major[edit | edit source]

If you are only interested in the major version number, use this http://arkdedicated.com/version/major instead. Example: 326. Game versions that differ in minor version numbers but share the same major version number should be compatible (in terms of connecting, mods, save games, etc.).

officialserverstatus.ini[edit | edit source]

This endpoint contains the text typically displayed in the upper left hand corner of the in-game ark server browser, and displays the health and current version of all the official Ark servers. The return text is formatted in ArkML.

Example: the URL http://arkdedicated.com/officialserverstatus.ini returns:

ARK Official Server Network Status: <RichColor Color="0, 1, 0, 1">Healthy (v223.2)</>

officialtributeenabled.html[edit | edit source]


This endpoint specifies is tribute (transfers) are enabled on the Official Server Network.

news.ini[edit | edit source]


This endpoint contains the text typically displayed in the upper right hand corner of Ark's main menu, and displays news regarding Ark. The return text is also formatted in ArkML. The text is not processed any further by the game, but from current observations additional data can be parsed from it.

After parsing the ArkML, each news entry is separated by two carriage return line feeds (\r\n\r\n). Each entry begins with a date string, followed by a colon, and ends with the entry's text. The date string consists of the full month name followed by a space and then the day of the month with no leading characters. In strftime format, the date can be represented as %B %-d.

officialservers.ini[edit | edit source]


This endpoint contains the list of official server hosts. The IP address of each server host is listed on a separate line, followed by a double forward slash (//) and then a short server name. Up to four game servers run on each official host. The query ports for each game server are on Steam's standard server port, plus 2, plus 4, and plus 6 (27015, 27017, 27019, 27021). See the server query protocol page to learn how to get information from them.

*This end-point is not used directly by the game.

globaladmins.txt[edit | edit source]


This endpoint contains the list of official server admins.

globaladmins.txt (Snail Games)[edit | edit source]


This endpoint contains the list of official server admins on servers Snail Games manages.

conquestbanlist.txt[edit | edit source]


This endpoint contains the list of accounts that are globally banned from the official conquest server network.

*This end-point has been said to not be updated anymore.

xboxbanlist.txt[edit | edit source]


This endpoint contains the list of accounts that are globally banned from the official server network on Xbox.

ps4banlist.txt[edit | edit source]


This endpoint contains the list of accounts that are globally banned from the official server network on PS4.

banlist.txt[edit | edit source]


This endpoint contains the list of accounts that are globally banned from the official server network.

dynamicconfig.ini[edit | edit source]


This endpoint contains the multipliers used for Official Evolution events.

pcnotification.html[edit | edit source]


http://arkdedicated.com/notification.html(xbox)[citation needed]



Platform-specific endpoints for in-game server-wide announcements.

Ark Mobile[edit | edit source]

Ark Mobile uses the same domain to get official servers. Instead of being in ini format, this file is formatted in JSON.


This endpoint provides a list of all official servers. Each server in the list uses the following JSON format.

  "ClusterId":"{\r\n\t\"NumReservedSlots\": 60,\r\n\t\"NumReservedPlayers\": 1,\r\n\t\"ClusterId\": \"ark\",\r\n\t\"Difficulty\": \"Hard\",\r\n\t\"Mode\": \"PVE\",\r\n\t\"REGION\": \"EU\"\r\n}",
  "Name":"Gauntlet (PVE-Hard-EU)"

If NumReservedSlots is equal to the maximum number of players, the client will make this server appear as a premium-only server. Changing the cluster ID away from "ark" will cause the server to not appear in the client. It is unknown what AllowDownloadItems, NPEnvironment, or AllowDownloadChars means.

Xbox[edit | edit source]



These endpoints contain JSON arrays of objects for each official and unofficial Xbox server.

Example object with IPs and domains stripped:


Nintendo Switch[edit | edit source]



Playstation[edit | edit source]