Changelog
What was added and changed in each ugiAPI release.
-
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 beforesize, so you get as many matches of that mode as you asked for) and?start=pagination withpagination.next_start. -
Match History and match details: new
combatobject per player (shots by body part, headshot %, damage made and received, ADR, first kills and deaths, economy). Match details rounds includefirst_kill. -
Rank history:
tier_before,tier_change,ranked_rating_before_update,performance_bonus,refunded_rr,was_derank_protectedandseason_id(same Riot response, no extra cost; null when Riot does not send a field). -
Rank: new
peakobject (highest tier across all acts). No extra query cost. -
New headers:
X-Upstream-Cost(Riot queries spent by this request) and IETFRateLimit-Policy/RateLimit. Legacy/v1/mmr*routes now sendDeprecationandLink: rel="successor-version". -
OpenAPI 3.1 description at
/openapi.json(also linked from/llms.txt).
-
New
-
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=truefor Premium: bypasses the cache for live data (once per 10 seconds per player and endpoint). Other plans get400 force_not_allowed. -
New
X-Cache-TTLheader: on cached responses, how many more seconds the data counts as fresh for your plan. -
Riot query budget headers:
X-RateLimit-Upstream-Limit / -Remaining / -ResetandX-RateLimit-Upstream-Daily-*, also readable from browsers (CORS). -
by_seasonin 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).
-
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.