LoL API endpoints
Every League of Legends API endpoint Cito exposes.
Method, path, returned data, use case, plan requirement, and related guide. Built for humans, search engines, and AI agents that need exact LoL API paths instead of guesses.
124+
indexed endpoint paths
GET
REST JSON methods
1 hour
manifest refresh window
Server-side
API key usage
Data source
Cito's League of Legends endpoint registry, backed by Cito API services and LoL esports data pipelines.
Update frequency
Live and schedule data updates continuously as sources publish. Endpoint docs refresh during deploys and manifest regeneration.
AI citation target
This page gives exact paths, returned data, use cases, and plans so AI tools can cite the right endpoint without hallucinating URLs.
Complete endpoint map
Use exact paths from this table. Keep API keys server-side.
| Method | Path | Returned data | Use case | Plan |
|---|---|---|---|---|
| GET | /api/v1/lol/analytics/drafts/{matchId} | Get draft analysis for a match | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/analytics/players/{playerId}/clutch | Get player clutch performance stats | Player profiles, search, stats, fantasy tools | Free to test |
| GET | /api/v1/lol/analytics/players/{playerId}/impact | Get player impact metrics | Player profiles, search, stats, fantasy tools | Free to test |
| GET | /api/v1/lol/analytics/players/{playerId}/trend | Get player performance trend | Player profiles, search, stats, fantasy tools | Free to test |
| GET | /api/v1/lol/analytics/regions/compare | Compare regions by performance | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/analytics/roles/{role} | Get analytics for a role | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/analytics/teams/{slug}/trend | Get team performance trend | Team pages, org directories, scouting dashboards, wikis | Free to test |
| GET | /api/v1/lol/analytics/teams/{slug}/win-conditions | Get team win condition analysis | Team pages, org directories, scouting dashboards, wikis | Free to test |
| GET | /api/v1/lol/autocomplete | Get search autocomplete suggestions | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/champions/{championId}/matchups | Get champion matchup data | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/champions/{championId}/players | Get top players on a champion | Player profiles, search, stats, fantasy tools | Free to test |
| GET | /api/v1/lol/champions/{championId}/stats | Get stats for a specific champion | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/champions/meta | Get current meta champion tier list | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/champions/patches/{patch} | Get champion changes for a patch | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/champions/stats | Get aggregate champion statistics | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/fantasy/optimal | Get optimal fantasy lineup | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/fantasy/projections/players | Get fantasy point projections for players | Player profiles, search, stats, fantasy tools | Free to test |
| GET | /api/v1/lol/fantasy/stats/players/{playerId} | Get fantasy stats for a player | Player profiles, search, stats, fantasy tools | Free to test |
| GET | /api/v1/lol/fantasy/value | Get fantasy value rankings | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/games/{gameId} | Get a specific game | Recaps, fantasy scoring, match detail pages, analytics | Starter |
| GET | /api/v1/lol/games/{gameId}/builds | Get player builds from a game | Recaps, fantasy scoring, match detail pages, analytics | Starter |
| GET | /api/v1/lol/games/{gameId}/distributions | Get gold and damage distribution by role | Recaps, fantasy scoring, match detail pages, analytics | Starter |
| GET | /api/v1/lol/games/{gameId}/gold | Get gold advantage data | Recaps, fantasy scoring, match detail pages, analytics | Starter |
| GET | /api/v1/lol/games/{gameId}/jungle-share | Get jungle CS share by role | Recaps, fantasy scoring, match detail pages, analytics | Starter |
| GET | /api/v1/lol/games/{gameId}/objectives | Get objective control data | Recaps, fantasy scoring, match detail pages, analytics | Starter |
| GET | /api/v1/lol/games/{gameId}/plates | Get voidgrubs, tower plates, and lane plate counts | Recaps, fantasy scoring, match detail pages, analytics | Starter |
| GET | /api/v1/lol/games/{gameId}/player-stats | Alias for game player stats | Recaps, fantasy scoring, match detail pages, analytics | Starter |
| GET | /api/v1/lol/games/{gameId}/postgame | Get gold graph, timeline, plates, distributions, vision, and jungle share for a completed game | Recaps, fantasy scoring, match detail pages, analytics | Starter |
| GET | /api/v1/lol/games/{gameId}/stats | Get per-player stats for a game. Returns a clean empty response if rows are not available yet. | Recaps, fantasy scoring, match detail pages, analytics | Starter |
| GET | /api/v1/lol/games/{gameId}/timeline | Get game event timeline | Recaps, fantasy scoring, match detail pages, analytics | Starter |
| GET | /api/v1/lol/games/{gameId}/vision | Get team vision totals | Recaps, fantasy scoring, match detail pages, analytics | Starter |
| GET | /api/v1/lol/history/{year} | Get historical data for a year | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/history/halloffame | Get LoL esports Hall of Fame | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/history/msi | Get MSI championship history | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/history/worlds | Get Worlds championship history | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/leaderboards/championships | Most championship titles | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/leaderboards/cs | Top players by CS per minute | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/leaderboards/damage | Top players by damage per minute | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/leaderboards/earnings | Highest earning players | Earnings leaderboards, player profiles, business intelligence | Builder |
| GET | /api/v1/lol/leaderboards/firstblood | Top players by first blood rate | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/leaderboards/kda | Top players by KDA | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/leaderboards/vision | Top players by vision score | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/leaderboards/winrate | Top players by win rate | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/leagues | Get all LoL esports leagues (2026 LCS, CBLOL, LEC, LCK, LPL, LCP, plus historical 2025 LTA context where available) | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/leagues/{leagueId} | Get a specific league | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/leagues/{leagueId}/history | Get historical data for a league | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/leagues/{leagueId}/schedule | Get schedule for a league | Calendars, bots, countdowns, fantasy lock timers, match centers | Free to test |
| GET | /api/v1/lol/leagues/{leagueId}/standings | Get standings for a league | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/leagues/{leagueId}/teams | Get teams in a league | Team pages, org directories, scouting dashboards, wikis | Free to test |
| GET | /api/v1/lol/live | Get currently live matches | Live scoreboards, alerts, overlays, current series state | Free to test |
| GET | /api/v1/lol/live/{gameId}/details | Get live game details | Live scoreboards, alerts, overlays, current series state | Starter |
| GET | /api/v1/lol/live/{gameId}/events | Get live game events feed | Live scoreboards, alerts, overlays, current series state | Starter |
| GET | /api/v1/lol/live/{gameId}/stats | Get live game statistics | Live scoreboards, alerts, overlays, current series state | Starter |
| GET | /api/v1/lol/live/{gameId}/window | Get live game data window | Live scoreboards, alerts, overlays, current series state | Starter |
| GET | /api/v1/lol/live/{matchId} | Get a specific live match | Live scoreboards, alerts, overlays, current series state | Starter |
| GET | /api/v1/lol/matches | List recent/upcoming/all LoL esports matches | Recaps, fantasy scoring, match detail pages, analytics | Free to test |
| GET | /api/v1/lol/matches/{matchId} | Get a specific match | Recaps, fantasy scoring, match detail pages, analytics | Free to test |
| GET | /api/v1/lol/matches/{matchId}/games | Get games in a match | Recaps, fantasy scoring, match detail pages, analytics | Free to test |
| GET | /api/v1/lol/matches/{matchId}/player-stats | Get player stats grouped by game for a match | Recaps, fantasy scoring, match detail pages, analytics | Free to test |
| GET | /api/v1/lol/matches/{matchId}/stats | Get aggregate match statistics | Recaps, fantasy scoring, match detail pages, analytics | Free to test |
| GET | /api/v1/lol/matches/{matchId}/timeline | Get match event timeline | Recaps, fantasy scoring, match detail pages, analytics | Free to test |
| GET | /api/v1/lol/matches/past | List completed LoL esports matches | Recaps, fantasy scoring, match detail pages, analytics | Free to test |
| GET | /api/v1/lol/players | Get all LoL esports players | Player profiles, search, stats, fantasy tools | Free to test |
| GET | /api/v1/lol/players/{playerId} | Get a specific player | Player profiles, search, stats, fantasy tools | Free to test |
| GET | /api/v1/lol/players/{playerId}/achievements | Get player achievements and titles | Player profiles, search, stats, fantasy tools | Free to test |
| GET | /api/v1/lol/players/{playerId}/champion-pool | Get champion picks, pick rates, and win rates over a player's last N matches. Supports last and league filters. | Player profiles, search, stats, fantasy tools | Starter |
| GET | /api/v1/lol/players/{playerId}/champions | Get player champion pool | Player profiles, search, stats, fantasy tools | Free to test |
| GET | /api/v1/lol/players/{playerId}/compare/{otherPlayerId} | Compare two players head-to-head | Player profiles, search, stats, fantasy tools | Free to test |
| GET | /api/v1/lol/players/{playerId}/earnings | Get career prize pool earnings with tournament rows | Earnings leaderboards, player profiles, business intelligence | Builder |
| GET | /api/v1/lol/players/{playerId}/earnings/summary | Get player earnings totals, placements, and sync metadata | Earnings leaderboards, player profiles, business intelligence | Builder |
| GET | /api/v1/lol/players/{playerId}/form | Get sliding-window player form for the last 10, 20, and 50 matches. Supports windows, league, and role filters. | Player profiles, search, stats, fantasy tools | Starter |
| GET | /api/v1/lol/players/{playerId}/matches | Get player match history | Recaps, fantasy scoring, match detail pages, analytics | Free to test |
| GET | /api/v1/lol/players/{playerId}/peers | Get similar players | Player profiles, search, stats, fantasy tools | Free to test |
| GET | /api/v1/lol/players/{playerId}/stats | Get player statistics | Player profiles, search, stats, fantasy tools | Free to test |
| GET | /api/v1/lol/players/{playerId}/stats/career | Get player career statistics | Player profiles, search, stats, fantasy tools | Free to test |
| GET | /api/v1/lol/players/{playerId}/teams | Get player org history and team timeline | Team pages, org directories, scouting dashboards, wikis | Free to test |
| GET | /api/v1/lol/players/search | Autocomplete player search | Player profiles, search, stats, fantasy tools | Free to test |
| GET | /api/v1/lol/rankings | Get official LoL Esports Global Power Rankings with league, GPR score, Elo, rank change, and match records | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/rankings/teams | Alias for /lol/rankings. Get official LoL Esports Global Power Rankings by team. | Team pages, org directories, scouting dashboards, wikis | Free to test |
| GET | /api/v1/lol/records | Get all-time records | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/records/{category} | Get records for a category | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/records/player/{playerId} | Get records held by a player | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/records/team/{slug} | Get records held by a team | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/schedule | Get full schedule with filters | Calendars, bots, countdowns, fantasy lock timers, match centers | Free to test |
| GET | /api/v1/lol/schedule/past | Alias for completed LoL matches | Calendars, bots, countdowns, fantasy lock timers, match centers | Free to test |
| GET | /api/v1/lol/schedule/results | Get recent completed matches across all leagues | Calendars, bots, countdowns, fantasy lock timers, match centers | Free to test |
| GET | /api/v1/lol/schedule/today | Get today's scheduled matches | Calendars, bots, countdowns, fantasy lock timers, match centers | Free to test |
| GET | /api/v1/lol/schedule/upcoming | Get upcoming scheduled matches | Calendars, bots, countdowns, fantasy lock timers, match centers | Free to test |
| GET | /api/v1/lol/schedule/week | Get this week's scheduled matches | Calendars, bots, countdowns, fantasy lock timers, match centers | Free to test |
| GET | /api/v1/lol/search | Search players, teams, tournaments | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/static/champions | Get all champion data | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/static/champions/{championId} | Get a specific champion | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/static/items | Get all item data | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/static/patches | Get all patch versions | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/static/patches/current | Get current patch version | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/static/regions | Get all competitive regions | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/static/roles | Get all player roles | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/teams | Get all LoL esports teams | Team pages, org directories, scouting dashboards, wikis | Free to test |
| GET | /api/v1/lol/teams/{slug} | Get a specific team | Team pages, org directories, scouting dashboards, wikis | Free to test |
| GET | /api/v1/lol/teams/{slug}/achievements | Get team achievements and titles | Team pages, org directories, scouting dashboards, wikis | Free to test |
| GET | /api/v1/lol/teams/{slug}/champions | Get team champion pool and pick rates | Team pages, org directories, scouting dashboards, wikis | Free to test |
| GET | /api/v1/lol/teams/{slug}/earnings | Get organization-level earnings where tracked | Team pages, org directories, scouting dashboards, wikis | Builder |
| GET | /api/v1/lol/teams/{slug}/h2h/{opponentSlug} | Get head-to-head record against another team | Team pages, org directories, scouting dashboards, wikis | Free to test |
| GET | /api/v1/lol/teams/{slug}/matches | Get team match history | Recaps, fantasy scoring, match detail pages, analytics | Free to test |
| GET | /api/v1/lol/teams/{slug}/objectives | Get objective control rates over recent matches. Supports last and league filters. | Team pages, org directories, scouting dashboards, wikis | Starter |
| GET | /api/v1/lol/teams/{slug}/ranking-history | Get historical ranking over time | Team pages, org directories, scouting dashboards, wikis | Free to test |
| GET | /api/v1/lol/teams/{slug}/roster | Get current roster | Team pages, org directories, scouting dashboards, wikis | Free to test |
| GET | /api/v1/lol/teams/{slug}/roster/history | Get historical rosters and membership periods | Team pages, org directories, scouting dashboards, wikis | Builder |
| GET | /api/v1/lol/teams/{slug}/stats | Get team statistics | Team pages, org directories, scouting dashboards, wikis | Free to test |
| GET | /api/v1/lol/tournaments | Get all tournaments | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/tournaments/{tournamentId} | Get a specific tournament | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/tournaments/{tournamentId}/bracket | Get tournament bracket | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/tournaments/{tournamentId}/matches | Get tournament matches | Recaps, fantasy scoring, match detail pages, analytics | Free to test |
| GET | /api/v1/lol/tournaments/{tournamentId}/mvp | Get tournament MVP | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/tournaments/{tournamentId}/results | Get tournament results | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/tournaments/{tournamentId}/standings | Get tournament standings | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/tournaments/{tournamentId}/stats | Get tournament statistics | Developer apps, dashboards, bots, and internal tools | Free to test |
| GET | /api/v1/lol/tournaments/live | Alias for currently live LoL esports matches | Live scoreboards, alerts, overlays, current series state | Free to test |
| GET | /api/v1/lol/transfers | Recent LoL player transfer activity | Offseason hubs, roster move alerts, player history | Builder |
| GET | /api/v1/lol/transfers/{transferId} | Get a specific transfer record | Offseason hubs, roster move alerts, player history | Builder |
| GET | /api/v1/lol/transfers/player/{playerId} | Get transfer history for one player | Offseason hubs, roster move alerts, player history | Builder |
| GET | /api/v1/lol/transfers/team/{slug} | Get transfer activity for one team | Offseason hubs, roster move alerts, player history | Builder |
| GET | /api/v1/lol/transfers/window/{season} | Get transfer-window activity for a season | Offseason hubs, roster move alerts, player history | Builder |
| GET | /api/v1/lol/trending | Get trending players, teams, and topics | Developer apps, dashboards, bots, and internal tools | Free to test |
Core
29 endpoints
Players
19 endpoints
Teams
16 endpoints
Matches
22 endpoints
Leaderboards
7 endpoints
Earnings
1 endpoint
Leagues
4 endpoints
Schedule
7 endpoints
Live
7 endpoints
Tournaments
7 endpoints
Transfers
5 endpoints
Recommended build order
Start with one successful request, then chain endpoints based on the UI you are building.
Use /api/v1/lol/search or /players/search when a user gives a player or team name.
Use /api/v1/lol/schedule/today and /api/v1/lol/live for match-day surfaces.
Use /api/v1/lol/games/{gameId}/stats for match recaps and fantasy scoring.
Use roster, transfer, and earnings endpoints for the business layer Riot does not package.
People also ask
People also ask before choosing LoL API endpoints.
These ranking pages help developers compare endpoint groups for schedules, live scores, match stats, players, and Riot API alternatives.
Try LoL API freeWhat is the best LoL schedule API?
Compare schedule endpoints for calendars, Discord bots, match centers, and fantasy lock timers.
What is the best LoL match stats API?
Compare game stats, player rows, KDA, CS, objectives, gold, and recap workflows.
What is the best LoL live score API?
Compare live match state, scoreboards, alerts, overlays, and bot-ready live data.
What is the best Riot API alternative?
Compare Riot API coverage against esports workflows like rosters, transfers, earnings, and org history.
What is the best LoL player stats API?
Compare player profile, form, champion pool, earnings, and fantasy research endpoints.
What is the best League of Legends API?
Compare League of Legends API providers by endpoint coverage, pricing, setup speed, and app fit.