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.
119+
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}/gold | Get gold advantage data | 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}/player-stats | Alias for game player stats | 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/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}/gold | Get real-time gold difference data for a live game | 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/teams | Get world team rankings sorted by rank | 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
28 endpoints
Players
19 endpoints
Teams
16 endpoints
Matches
17 endpoints
Leaderboards
7 endpoints
Earnings
1 endpoint
Leagues
4 endpoints
Schedule
7 endpoints
Live
8 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.