Guild Wars 2 API

Base URL

https://api.guildwars2.com/v2

Authentication

Public game data needs no key. Account endpoints (inventory, characters, wallet) require a player-generated API key, which we did not use or need.

Rate limit

The response carried `x-rate-limit-limit: 600`. ArenaNet operates a leaky-bucket limiter per address; batching ids is the intended way to stay inside it.

Pricing

Free. It is ArenaNet's own API, funded as part of the game.

CORS

Enabled — callable directly from browser JavaScript

Official docs

Read the docs

Every request below was executed against the live API on 2026-08-21, and the response shown is the real body it returned — not an illustration.

curl 'https://api.guildwars2.com/v2/items?ids=24,68'

const res = await fetch("https://api.guildwars2.com/v2/items?ids=24,68");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

import requests

res = requests.get("https://api.guildwars2.com/v2/items?ids=24,68", timeout=20)
res.raise_for_status()
print(res.json())

[
  {
    "name": "Sealed Package of Snowballs",
    "description": "Open this package to create several snowballs that can hit anyone else holding a snowball.",
    "type": "Consumable",
    "level": 0,
    "rarity": "Basic",
    "vendor_value": 0,
    "game_types": [
      "Pve"
    ],
    "flags": [
      "NoSalvage"
    ],
    "restrictions": [],
    "id": 24,
    "chat_link": "[&AgEYAAAA]",
    "icon": "https://render.guildwars2.com/file/1D05D1EE04E16E69710E1EAB11AC466BBF105778/219347.png",
    "details": {
      "type": "Generic"
    }
  },
  {
    "name": "Mighty Country Coat",
    "description": "",
    "type": "Armor",
    "level": 0,
    "rarity": "Basic",
    "vendor_value": 6,
    "default_skin": 13,
    "game_types": [
      "Activity",
      "Wvw",
      "Dungeon",
      "Pve"
    ],
    "flags": [
      "NotUpgradeable"
    ],
    "restrictions": [],
    "id": 68,
    "chat_link": "[&AgFEAAAA]",
    "icon": "https://render.guildwars2.com/file/F03808FFE89B40044671EED2E427053B389BE0A1/61007.png",
    "details": {
      "type": "Coat",
      "weight_class": "Light",
      "defense": 23,
      "infusion_slots": [],
      "attribute_adjustment": 11.583,
      "infix_upgrade": {
        "id": 137,
        "attributes": [
          {
            "attribute": "Power",
            "modifier": 4
          }
        ]
      },
      "secondary_suffix_item_id": ""
    }
  }
]

(root)array

An array of item objects when `ids` is supplied; an array of bare integers when it is not.

idinteger

Item id. Note it appears well down the object rather than first — do not rely on key order.

descriptionstring

Flavour or effect text. Empty string when absent, never null, so a falsy check is the right test.

raritystring

`Basic`, `Fine`, `Masterwork`, `Rare`, `Exotic`, `Ascended`, `Legendary` — the values the game's UI colours by.

flagsarray of strings

Behaviour markers such as `NoSalvage`, `NotUpgradeable`, `AccountBound`. Empty array rather than null when none apply.

chat_linkstring

The in-game chat code, for example `[&AgEYAAAA]`. Paste-able directly into the game client.

iconstring

Absolute render-service URL. Stable, and safe to hotlink.

detailsobject

Polymorphic sub-object whose shape depends on `details.type`. Switch on that field before reading anything else inside it.

details.secondary_suffix_item_idstring

An empty string where you would expect a number or null — a long-standing quirk of the armour schema.

• Track trading post prices for crafting materials
• Build a recipe calculator that costs out a legendary weapon
• Show live World vs World match scores on a guild site
• Render item tooltips with correct rarity colours and chat links
• Sync a wardrobe or achievement tracker from public game data