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 21 Aug 2026, 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

If Guild Wars 2 API does not fit, these game & anime apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.