English Premier League

Premier League API. Every goal, card and shot, with where it happened.

Live scores, match events, formations, lineups and player stats for every Premier League match, in the same schema as Statpad's other leagues.

Alias
epl
Status
Live
REST
from $19 a month
WebSocket
from $49 a month

Sample game

Manchester United 4, Aston Villa 4. November 8, 2026.

These are untrimmed responses from the real API for one EPL game, free to download without a key. The game was replayed through Statpad's ingest into a fresh database, so the ids and every updated_at are from that run.

An eight-goal draw with 106 events, both squads and every player's stats. United came back from 4 to 2 with goals in the 2nd and 6th minutes of stoppage time.

The shot map post on the blog draws every shot in this match from the plays endpoint.

Its play-by-play has 106 entries:

  • foul 27
  • shot_off_target 13
  • substitution 10
  • shot_blocked 9
  • corner 9
  • shot_on_target 7
  • delay_start 7
  • delay_end 7

Built on this game: A shot map of Manchester United 4–4 Aston Villa in 125 lines of TypeScript.

GET /v1/epl/games/{id}/plays · one playFull file
{
  "away_score": 4,
  "baseball": null,
  "basketball": null,
  "clock_seconds": null,
  "description": "Goal: Patrick Dorgu (Manchester United), header, assisted by Bruno Fernandes. Manchester United 4, Aston Villa 4.",
  "football": null,
  "game_id": "01a1eee7-199e-7db2-99d7-b07cfeb058aa",
  "group_id": null,
  "hockey": null,
  "home_score": 4,
  "id": "01a1eee7-199f-7260-96e5-4e3f49679433",
  "is_official": true,
  "is_scoring": true,
  "participants": [
    {
      "player_id": "01a1eee7-199e-7e1d-8c0c-2e96f92c153a",
      "role": "assist",
      "team_id": "01a1eee7-199e-7dc0-8334-59d669371c01"
    },
    {
      "player_id": "01a1eee7-199e-7e4f-8997-474ab3f2f632",
      "role": "scorer",
      "team_id": "01a1eee7-199e-7dc0-8334-59d669371c01"
    }
  ],
  "period": 2,
  "period_half": null,
  "points": 1,
  "sequence": 1794162415000,
  "soccer": {
    "added_minute": 6,
    "body_part": "head",
    "end_x": 100,
    "end_y": 48.3,
    "field_x": 97.3,
    "field_y": 48.1,
    "is_shootout": false,
    "minute": 90,
    "play_type": "goal"
  },
  "team_id": "01a1eee7-199e-7dc0-8334-59d669371c01",
  "type": "goal",
  "updated_at": "2026-11-18T13:44:45.213136Z",
  "version": 1,
  "wall_clock": "2026-11-08T18:26:55Z"
}

The last goal: Patrick Dorgu's header at 90+6. A soccer event carries the minute, body_part and field_x and field_y, and participants names the scorer and the assist.

GET /v1/epl/games/{id}/boxscore · one playerFull file
{
  "game_id": "01a1eee7-199e-7db2-99d7-b07cfeb058aa",
  "player_id": "01a1eee7-199e-7e1d-8c0c-2e96f92c153a",
  "stats": {
    "soccer": {
      "sub_ins": 0,
      "offsides": 1,
      "own_goals": 0,
      "red_cards": 0,
      "appearances": 1,
      "shots_faced": 0,
      "total_goals": 1,
      "total_shots": 6,
      "goal_assists": 1,
      "yellow_cards": 0,
      "fouls_suffered": 0,
      "goals_conceded": 4,
      "fouls_committed": 3,
      "shots_on_target": 1
    }
  },
  "team_id": "01a1eee7-199e-7dc0-8334-59d669371c01",
  "version": 1
}

Bruno Fernandes's line in the box score: one soccer category per player.

Every file from this game

A whole NFL game you can replay change by change is on Sample responses.

Endpoints

REST at https://api.statpad.dev and one WebSocket at wss://stream.statpad.dev/v1/stream. Every league uses the same paths and JSON, so changing epl to another alias keeps your parser working.

Request or streamWhat it returns
GET /v1/epl/games?date=2026-11-08A day's games with status, start time and score. Pass from and to instead for a range of up to 31 days.
GET /v1/epl/games/{id}One game with its teams, venue and live state
GET /v1/epl/games/{id}/playsEvery play or match event, in game order
GET /v1/epl/games/{id}/boxscoreA stat line for each player
GET /v1/epl/games/{id}/rosterThe players in the game, with team and jersey
GET /v1/epl/games/{id}/changes?after_seq=0Every change after a seq: the same journal the stream sends
GET /v1/epl/teamsThe league's teams
game:<id>WebSocket stream for one game: the game, its live state, plays, stats and roster, in seq order
league:eplWebSocket stream for what the league's games share: teams, players and venues, plus injuries

A client that reconnects to the stream with the last seq it saw gets exactly the changes it missed. The API reference has every parameter and schema.

What every Premier League game has

From Coverage by league. Everything but injuries comes from the live game feed and updates during the game.

DataWhereEPL
ScheduleGET /v1/{league}/gamesEvery match the league has published with both teams known, through the end of its season, with status, start time and score
Live statelive_state on GET /games/{id}Half, match minute, whether the clock is running, stoppage time (shown and announced), formations, red cards and shoot-out score
Game timingstarted_at, ended_at on the game; last_play_id on the live stateKickoff and the final whistle, from the match events' own clock; the newest event
Play-by-playGET /games/{id}/playsKey events: goals, shots (on target, off target, blocked, woodwork), penalties, cards, substitutions, corners, fouls, offsides and VAR decisions, with the match minute, body part, pitch position and the players involved with their roles
DrivesGET /games/{id}/play-groupsNot applicable. Soccer events belong to no group.
Player box scoreplayers in GET /games/{id}/boxscoreOne soccer line per player: goals, assists, shots, shots on target, saves, goals conceded, fouls, offsides and cards
Game rosterGET /games/{id}/rosterThe match squads, with starters, positions and jerseys
InjuriesGET /v1/epl/injuriesNot filled yet
Teams, players and venues/teams, /players/{id}Every team and player that has appeared in a match
Change journalGET /games/{id}/changes and the streamYes
  • Every goal, shot, card, substitution, corner, foul and offside, with the match minute and added time
  • field_x and field_y on the pitch for each event, and end_x and end_y where a shot finished
  • The body part for shots and goals, and each player's role: scorer, shooter, assist, passer, fouler
  • Formations and red cards on the live state
  • Soccer events belong to no group, so a match has no play-groups. Their time is soccer.minute and soccer.added_minute, not clock_seconds.

Box score stat codes in this game

CategoryCodes
soccersaves, sub_ins, own_goals, red_cards, appearances, shots_faced, total_goals, total_shots, goal_assists, yellow_cards, fouls_suffered, goals_conceded, fouls_committed, shots_on_target, offsides

A player only has the categories and codes that apply to them, so treat every code as optional.

Not filled yet

These endpoints and fields are part of the API, but nothing fills them for EPL today. Code written against them keeps working when the data arrives.

DataWhereWhat you get today
Team totalsteams in the box scoreAn empty list. Add up the player lines for team totals.
Score by periodperiod_scores on the game and the box scoreAn empty list. Plays carry the score after each play.
Team rostersGET /teams/{id}/rosterAn empty list. A game's roster lists the players in that game.
Depth chartsGET /teams/{id}/depth-chart404
InjuriesGET /{league}/injuriesAn empty list
Injury practice status and notespractice_status and comment on an injurynull
TransactionsGET /{league}/transactions?since=An empty list
Season stats and leadersGET /players/{id}/stats, GET /seasons/{year}/{type}/leadersEmpty lists
Player detailsbirth_date, height_in, weight_lb, college and draft on playersnull

History, and staying right

Statpad started collecting each league in November 2026 and doesn't backfill earlier games or seasons. Once collected, a game's plays, box score and roster stay readable over REST for good, and its change journal for at least 7 days after it ends.

A play or stat line can change after it first appears, during the game and shortly after it. The newer version arrives as an upsert with a higher version, on the same stream and in the same seq order as everything else. Key what you store by id and keep the highest version, and your app shows the current data with no special handling.

Pricing

Every plan includes all 10 leagues and every REST endpoint. Plans differ in volume, streaming and keys, and the limits are hard caps with no overage.

Compare every limit
  • Developer

    $19 a month

    • 25,000 requests a month
    • 1 request a second, burst of 10
    • REST only, no WebSocket
  • Pro

    $49 a month

    • 150,000 requests a month
    • 10 requests a second, burst of 30
    • WebSocket: 5 connections, 20 subscriptions
  • Business

    $299 a month

    • 2,000,000 requests a month
    • 25 requests a second, burst of 100
    • WebSocket: 10 connections, 150 subscriptions