Dev Tools

Gamertag and XUID lookups for developers and the modding scene, plus a free JSON API.

Public API

Free JSON endpoints. Please cache on your side - requests are rate limited per IP, and heavy use gets blocked. Full reference and key management live in the developer portal.

GET /api/player/<gamertag> API key required

Public profile summary for any gamertag, cached for about 10 minutes. This is the only endpoint that needs a key, because it is the only one that spends our paid Xbox API quota. Send it as the X-API-Key header. Ask for a key with /feedback in Discord.

{
  "gamertag": "x2wmt",
  "xuid": "2535434113411095",
  "gamerscore": 52000,
  "tier": "GOLD",
  "presence": { "state": "Online", "playing": "Halo Infinite" },
  "topGames": [ { "name": "Halo Infinite", "gamerscore": 1730, "completion": 71 } ],
  "recentGames": [ { "name": "Forza Horizon 5", "lastPlayed": "2026-07-25T18:02:11Z" } ],
  "urls": {
    "profile": "https://xbguide.com/player/x2wmt",
    "card": "https://xbguide.com/player/x2wmt/card.png"
  }
}

GET /api/status

Live Xbox Live status from our independent monitor: per-service state, latency, 48h/90d history, incidents, and Microsoft's official status.

GET /api/xbox360/archive.json

The Xbox 360 infrastructure archive: every address these services have ever resolved to, and every change observed since monitoring began. Free to use for preservation and research work. Please credit xbguide.com/xbox360.

Errors

404 unknown gamertag • 429 rate limited (Retry-After header) • 400 invalid input