API:2/worlds
From Guild Wars 2 Wiki
< API:2
Jump to navigationJump to search
/v2/worlds
- HTTP method
- GET
- Format
- json
- API version
- version 2
- Release date
- 2014-10-24
- Scope
- none
- Optional
- none
This resource returns information about the available worlds, or servers.
Parameters
lang
– Request localized information.
Response
If the root endpoint (/v2/worlds
) is accessed without specifying an id, a list of all ids is returned. When multiple ids are requested using the ids
parameter, a list of response objects is returned.
For each requested world id, an object with the following properties is returned:
id
(number) – The world id.name
(string) – The world name.population
(string) – The world population level. One of:Low
,Medium
,High
,VeryHigh
,Full
Notes
- The first digit of the id indicates the world's region.
1
is North America,2
is Europe. - The second digit of the id currently correlates with the world's assigned language:
1
means French,2
means German, and3
means Spanish.
Examples
https://api.guildwars2.com/v2/worlds?ids=1001,1002,1003
[ { "id": 1001, "name": "Anvil Rock", "population": "Medium" }, { "id": 1002, "name": "Borlis Pass", "population": "Medium" }, { "id": 1003, "name": "Yak's Bend", "population": "Full" } ]
Querying all worlds
https://api.guildwars2.com/v2/worlds?ids=all
[ { "id": 1001, "name": "Anvil Rock", "population": "Medium" }, { "id": 1002, "name": "Borlis Pass", "population": "Medium" }, { "id": 1003, "name": "Yak's Bend", "population": "Full" }, { "id": 1004, "name": "Henge of Denravi", "population": "High" }, { "id": 1005, "name": "Maguuma", "population": "VeryHigh" }, { "id": 1006, "name": "Sorrow's Furnace", "population": "Medium" }, { "id": 1007, "name": "Gate of Madness", "population": "Medium" }, { "id": 1008, "name": "Jade Quarry", "population": "Full" }, { "id": 1009, "name": "Fort Aspenwood", "population": "VeryHigh" }, { "id": 1010, "name": "Ehmry Bay", "population": "Medium" }, { "id": 1011, "name": "Stormbluff Isle", "population": "VeryHigh" }, { "id": 1012, "name": "Darkhaven", "population": "High" }, { "id": 1013, "name": "Sanctum of Rall", "population": "Medium" }, { "id": 1014, "name": "Crystal Desert", "population": "VeryHigh" }, { "id": 1015, "name": "Isle of Janthir", "population": "Medium" }, { "id": 1016, "name": "Sea of Sorrows", "population": "High" }, { "id": 1017, "name": "Tarnished Coast", "population": "Full" }, { "id": 1018, "name": "Northern Shiverpeaks", "population": "High" }, { "id": 1019, "name": "Blackgate", "population": "Full" }, { "id": 1020, "name": "Ferguson's Crossing", "population": "Medium" }, { "id": 1021, "name": "Dragonbrand", "population": "High" }, { "id": 1022, "name": "Kaineng", "population": "Medium" }, { "id": 1023, "name": "Devona's Rest", "population": "Medium" }, { "id": 1024, "name": "Eredon Terrace", "population": "Medium" }, { "id": 2001, "name": "Fissure of Woe", "population": "Medium" },` { "id": 2002, "name": "Desolation", "population": "VeryHigh" }, { "id": 2003, "name": "Gandara", "population": "VeryHigh" }, { "id": 2004, "name": "Blacktide", "population": "Medium" }, { "id": 2005, "name": "Ring of Fire", "population": "Medium" }, { "id": 2006, "name": "Underworld", "population": "Medium" }, { "id": 2007, "name": "Far Shiverpeaks", "population": "VeryHigh" }, { "id": 2008, "name": "Whiteside Ridge", "population": "Medium" }, { "id": 2009, "name": "Ruins of Surmia", "population": "Medium" }, { "id": 2010, "name": "Seafarer's Rest", "population": "Full" }, { "id": 2011, "name": "Vabbi", "population": "Medium" }, { "id": 2012, "name": "Piken Square", "population": "VeryHigh" }, { "id": 2013, "name": "Aurora Glade", "population": "High" }, { "id": 2014, "name": "Gunnar's Hold", "population": "High" }, { "id": 2101, "name": "Jade Sea [FR]", "population": "VeryHigh" }, { "id": 2102, "name": "Fort Ranik [FR]", "population": "Medium" }, { "id": 2103, "name": "Augury Rock [FR]", "population": "High" }, { "id": 2104, "name": "Vizunah Square [FR]", "population": "VeryHigh" }, { "id": 2105, "name": "Arborstone [FR]", "population": "Medium" }, { "id": 2201, "name": "Kodash [DE]", "population": "Full" }, { "id": 2202, "name": "Riverside [DE]", "population": "VeryHigh" }, { "id": 2203, "name": "Elona Reach [DE]", "population": "VeryHigh" }, { "id": 2204, "name": "Abaddon's Mouth [DE]", "population": "VeryHigh" }, { "id": 2205, "name": "Drakkar Lake [DE]", "population": "VeryHigh" }, { "id": 2206, "name": "Miller's Sound [DE]", "population": "Medium" }, { "id": 2207, "name": "Dzagonur [DE]", "population": "Medium" }, { "id": 2301, "name": "Baruch Bay [SP]", "population": "VeryHigh" } ]