Game APIs/League of Legends API

League of Legends API

Player earnings, org history, transfers, live matches, and esports data

BASEhttps://api.citoapi.com/api/v1
API RootAppend any League of Legends endpoint path below.

LoL live webhooks are available on One Game Starter and higher paid plans

Subscribe to live state, gold swing, objective, kill, tower, match started, score updated, and match completed events from the dashboard webhook page. CitoAPI does not expose a public WSS stream right now; webhooks are the push path, and REST endpoints return the latest payload.

GET /api/v1/lol/webhooks/eventsUpgrade for webhooks

LoL Webhook Events

Push events available for live match and score automation.

EVENTlol.match.started
startedDelivered to configured webhook destinations on paid plans.
EVENTlol.live.game_started
game startedDelivered to configured webhook destinations on paid plans.
EVENTlol.live.state
stateDelivered to configured webhook destinations on paid plans.
EVENTlol.live.gold_swing
gold swingDelivered to configured webhook destinations on paid plans.
EVENTlol.live.objective
objectiveDelivered to configured webhook destinations on paid plans.
EVENTlol.live.kill_update
kill updateDelivered to configured webhook destinations on paid plans.
EVENTlol.live.tower_destroyed
tower destroyedDelivered to configured webhook destinations on paid plans.
EVENTlol.score.updated
updatedDelivered to configured webhook destinations on paid plans.
EVENTlol.match.completed
completedDelivered to configured webhook destinations on paid plans.

Players

Player stats, form, champion pools, earnings, and team history.

GET/api/v1/lol/players/{playerId}/earnings
Player earningsPlayer prize pool earnings with tournament rows

Summary

Player prize pool earnings with tournament rows

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/players/{playerId}/earnings" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/players/{playerId}/earnings/summary
Player Earnings SummaryPlayer earnings totals, placement counts, and sync metadata

Summary

Player earnings totals, placement counts, and sync metadata

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/players/{playerId}/earnings/summary" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/players/{playerId}/teams
Player teamsPlayer org history and team timeline

Summary

Player org history and team timeline

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/players/{playerId}/teams" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/players/{playerId}/stats
Player statsPlayer statistics and recent performance rows

Summary

Player statistics and recent performance rows

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/players/{playerId}/stats" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/players/{playerId}/form
Player formSliding-window player form for last 10, 20, and 50 matches with optional league and role filters

Summary

Sliding-window player form for last 10, 20, and 50 matches with optional league and role filters

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/players/{playerId}/form" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/players/{playerId}/champion-pool
Player Champion PoolRecent champion picks, pick rates, and decided-game win rates over the player's last N matches

Summary

Recent champion picks, pick rates, and decided-game win rates over the player's last N matches

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/players/{playerId}/champion-pool" \
  -H "x-api-key: YOUR_CITO_API_KEY"

Teams & Rosters

Professional teams, objectives, roster history, and team timelines.

GET/api/v1/lol/players/{playerId}/teams
Player teamsPlayer org history and team timeline

Summary

Player org history and team timeline

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/players/{playerId}/teams" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/teams/{slug}/roster/history
Team Roster HistoryHistorical team rosters and date ranges

Summary

Historical team rosters and date ranges

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/teams/{slug}/roster/history" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/teams
List TeamsProfessional LoL teams

Summary

Professional LoL teams

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/teams" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/teams/{slug}/objectives
Team ObjectivesTeam objective control rates over recent matches with optional league filter

Summary

Team objective control rates over recent matches with optional league filter

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/teams/{slug}/objectives" \
  -H "x-api-key: YOUR_CITO_API_KEY"

Transfers

Recent movement and player/team transfer history.

GET/api/v1/lol/transfers
Recent TransfersRecent player transfers with filters

Summary

Recent player transfers with filters

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/transfers" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/transfers/player/{playerId}
Player TransfersTransfer history for one player

Summary

Transfer history for one player

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/transfers/player/{playerId}" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/transfers/team/{slug}
Team TransfersTransfer activity for one team

Summary

Transfer activity for one team

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/transfers/team/{slug}" \
  -H "x-api-key: YOUR_CITO_API_KEY"

Live Matches

Active matches, live series state, visual state, and live aliases.

GET/api/v1/lol/live
Live MatchesCurrently active LoL esports matches and live match IDs

Summary

Currently active LoL esports matches and live match IDs

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/live" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/matches/live
Live MatchesAlias for currently active pro matches

Summary

Alias for currently active pro matches

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/matches/live" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/live/{matchId}/series
Live SeriesLive series state with completed games, score, and current game context

Summary

Live series state with completed games, score, and current game context

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/live/{matchId}/series" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/live/{gameId}/visual-state
Live Visual StateAccepted near-live visual reads for game time, gold, kills, towers, dragons, and barons

Summary

Accepted near-live visual reads for game time, gold, kills, towers, dragons, and barons

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/live/{gameId}/visual-state" \
  -H "x-api-key: YOUR_CITO_API_KEY"

Matches & Games

Match detail, games, player stats, postgame data, vision, plates, and jungle share.

GET/api/v1/lol/matches/live
Live MatchesAlias for currently active pro matches

Summary

Alias for currently active pro matches

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/matches/live" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/matches/{id}
Match DetailMatch detail by stored match ID or raw LoL esports match ID

Summary

Match detail by stored match ID or raw LoL esports match ID

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/matches/{id}" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/matches/{id}/games
Match GamesGames inside a match, including raw game IDs where available

Summary

Games inside a match, including raw game IDs where available

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/matches/{id}/games" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/games/{gameId}
games gameIdGame details by stored ID or raw LoL esports game ID

Summary

Game details by stored ID or raw LoL esports game ID

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/games/{gameId}" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/games/{gameId}/stats
Game statsStored per-player stats for a specific game

Summary

Stored per-player stats for a specific game

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/games/{gameId}/stats" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/games/{gameId}/player-stats
Game Player StatsAlias for game-level player stat rows

Summary

Alias for game-level player stat rows

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/games/{gameId}/player-stats" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/games/{gameId}/postgame
Game postgameCompleted-game gold graph, timeline, plates, role distributions, vision, and jungle share

Summary

Completed-game gold graph, timeline, plates, role distributions, vision, and jungle share

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/games/{gameId}/postgame" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/games/{gameId}/plates
Game platesVoidgrubs, tower plates, and lane plate counts for one game

Summary

Voidgrubs, tower plates, and lane plate counts for one game

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/games/{gameId}/plates" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/games/{gameId}/distributions
Game distributionsGold and damage distribution by role for one game

Summary

Gold and damage distribution by role for one game

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/games/{gameId}/distributions" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/games/{gameId}/vision
Game visionTeam vision totals for one game

Summary

Team vision totals for one game

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/games/{gameId}/vision" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/games/{gameId}/jungle-share
Game jungle shareJungle CS share data by role for one game

Summary

Jungle CS share data by role for one game

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/games/{gameId}/jungle-share" \
  -H "x-api-key: YOUR_CITO_API_KEY"

Schedule & Standings

Today, upcoming schedule, and published league standings.

GET/api/v1/lol/schedule/today
Today ScheduleToday’s match schedule for LoL esports apps

Summary

Today’s match schedule for LoL esports apps

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/schedule/today" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/schedule/upcoming
Upcoming ScheduleUpcoming LoL esports schedule

Summary

Upcoming LoL esports schedule

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/schedule/upcoming" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/lol/leagues/{leagueId}/standings
League StandingsLeague standings, returning an empty rankings array when standings are not published yet

Summary

League standings, returning an empty rankings array when standings are not published yet

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/leagues/{leagueId}/standings" \
  -H "x-api-key: YOUR_CITO_API_KEY"

Webhooks

Supported webhook event names for production push workflows.

GET/api/v1/lol/webhooks/events
Webhook EventsSupported LoL webhook events for paid plans

Summary

Supported LoL webhook events for paid plans

League of LegendsREST
curl "https://api.citoapi.com/api/v1/lol/webhooks/events" \
  -H "x-api-key: YOUR_CITO_API_KEY"

Player Earnings

[
  {
    "tournamentName": "LCK 2026 Season Opening",
    "tournamentDate": "2026-01-09T00:00:00.000Z",
    "placement": 1,
    "earnings": 0,
    "league": "LCK",
    "orgSlugAtTime": "east-3"
  },
  {
    "tournamentName": "2025 World Championship",
    "tournamentDate": "2025-11-09T00:00:00.000Z",
    "placement": 1,
    "earnings": 200000,
    "prizePool": 1000000,
    "tier": "S-Tier",
    "league": "Worlds",
    "orgSlugAtTime": "east-3"
  }
]

Org and Roster History

{
  "success": true,
  "data": {
    "playerId": "c76dc4df-1a6f-4c83-b7ba-44cf213e0291",
    "playerName": "Faker",
    "teams": [
      {
        "teamSlug": "t1",
        "teamName": "T1",
        "role": "MID",
        "startedAt": "2026-02-01T00:00:00.000Z",
        "endedAt": null
      },
      {
        "teamSlug": "lck-allstars",
        "teamName": "LCK All-Stars",
        "role": "MID",
        "startedAt": "2026-02-01T00:00:00.000Z",
        "endedAt": null
      }
    ],
    "transfersEndpoint": "/api/v1/lol/transfers/player/{playerId}"
  }
}