FOOTBALL API
Sign inRequest a key
The collectionDocumentationMembershipStatusSupport
Sign inRequest a key
Documentation / Stats

FOOTBALL KICKOFF TIME STATISTICS API

Kickoff times
Complimentary key

Results by local kickoff time and by day of the week, by competition and season. On the complimentary key it reads this season's Premier League.

GET/v1/stats/kickoff
TRY ITComplimentary
Kept in this browser for every docs page. No key yet? Get a free key
GET https://api.footballapi.org/v1/stats/kickoff?competition=premier-league&group_by=season
The answer appears below, with its status and time.
curl "https://api.footballapi.org/v1/stats/kickoff?competition=premier-league&group_by=season" \
  -H "X-API-Key: your key"

PARAMETERS

competitionstringA competition from /v1/competitions, such as premier-league. Leave it out for every competition your key reads.
seasonintegerThe first year of the season: 2026 for 2026/27.From 2015, or the competition's first season
group_bystringHow the figures are split: by competition, season, country, or competition and season.competition or season or country or competition_season

RETURNS

hourstringKickoff hour, local time
matchesintegerMatches counted
goals_per_gamenumberGoals scored a match, on average
home_win_pctnumberShare of matches the home side won, as a percentage
draw_pctnumberShare of matches drawn, as a percentage
away_win_pctnumberShare of matches the away side won, as a percentage

EXAMPLE ANSWER

200GET /v1/stats/kickoff?competition=premier-league&group_by=season, taken 21 Oct 2026, first rows shown
{
  "data": [
    {
      "hour": "11:00",
      "matches": 92,
      "goals_per_game": 3.087,
      "home_win_pct": 47.83,
      "draw_pct": 23.91,
      "away_win_pct": 28.26
    },
    {
      "hour": "12:00",
      "matches": 799,
      "goals_per_game": 2.755,
      "home_win_pct": 42.3,
      "draw_pct": 23.65,
      "away_win_pct": 34.04
    }
  ],
  "meta": {
    "count": 10,
    "group_by": "season",
    "request_id": "req_9acc972fd115c02c"
  }
}

ERRORS

401unauthorizedNo key, or a key we do not know.
400bad_requestA parameter is missing or not in the right form; the message names it.
403upgrade_requiredAnything outside this season's Premier League, on the complimentary key.
404not_foundAn id or competition we do not have.
422unknown_parameterA parameter this endpoint does not take.
429quota_exceededThe day's 50 calls are used, on the complimentary key; they reset at 00:00 UTC.
PREVIOUSHalf timeNEXTReferee stats