API:2/worlds

From Guild Wars 2 Wiki
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, and 3 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" }
]