Changelog

What was added and changed in each ugiAPI release.

  1. v1.2.0

    Latest
    • New /v1/stored-matches/{region}/{name}/{tag} and /v1/by-puuid/stored-matches/{region}/{puuid}: matches kept in our match store with mode, map, agent and act filters, pagination and a summary (win %, K/D, headshot %, ADR, ACS). No Riot query cost.
    • Match History: ?mode= filter (applied by Riot before size, so you get as many matches of that mode as you asked for) and ?start= pagination with pagination.next_start.
    • Match History and match details: new combat object per player (shots by body part, headshot %, damage made and received, ADR, first kills and deaths, economy). Match details rounds include first_kill.
    • Rank history: tier_before, tier_change, ranked_rating_before_update, performance_bonus, refunded_rr, was_derank_protected and season_id (same Riot response, no extra cost; null when Riot does not send a field).
    • Rank: new peak object (highest tier across all acts). No extra query cost.
    • New headers: X-Upstream-Cost (Riot queries spent by this request) and IETF RateLimit-Policy / RateLimit. Legacy /v1/mmr* routes now send Deprecation and Link: rel="successor-version".
    • OpenAPI 3.1 description at /openapi.json (also linked from /llms.txt).
  2. v1.1.0

    • Plan-based data freshness: live data (account, rank, rank history, match list) is at most 300 s old on Basic, 120 s on Advanced and 30 s on Premium. Older entries are refetched.
    • ?force=true for Premium: bypasses the cache for live data (once per 10 seconds per player and endpoint). Other plans get 400 force_not_allowed.
    • New X-Cache-TTL header: on cached responses, how many more seconds the data counts as fresh for your plan.
    • Riot query budget headers: X-RateLimit-Upstream-Limit / -Remaining / -Reset and X-RateLimit-Upstream-Daily-*, also readable from browsers (CORS).
    • by_season in rank responses: per act final tier and RR, wins, games, peak win tier and leaderboard rank (no extra query cost).
    • Webhooks and tracked players: get notified on a new match, level or rank change instead of polling (match.new, account.level_changed, rank.changed). Advanced 10 players / 5 min, Premium 50 players / 1 min.
    • Webhook deliveries are signed with X-UGI-Signature (HMAC-SHA256), only go to https URLs on public IP addresses and never follow redirects. Failed deliveries are retried after 1, 5 and 30 minutes.
    • Panel: data freshness on key cards and details; new Webhooks page (secret, test delivery, player list, recent deliveries).
    • Docs: webhook section, signature verification examples (PHP, Node.js, Python), this changelog and /llms.txt.
    • If a plan-based refresh temporarily fails (budget or outage), the still-valid cached entry is served instead of an error (X-Cache-TTL: 0).
  3. v1.0.4

    • Account, rank, rank history, match list, match detail, leaderboard, content and status endpoints; per-key minute/day quotas, Riot query budget, IP/Origin restrictions, ETag/304 and a consistent error body.

Short machine-readable summary: /llms.txt.