List fixtures

GET /v1/fixtures

The window view: fixtures and results for a time window of up to 24 hours (default: today UTC), or every in-play match with ?status=live. For a whole season or one team's matches, see /v1/leagues/{id}/fixtures and /v1/teams/{id}/fixtures. Add ?include=odds,events,stats to expand every row in place — one call per screen, not one call per match. How far back you can query follows your plan: 3 months on Free, 12 months on Pro, back to 2014 on Ultra.

Parameters

start_time	optional	Window start as a unix timestamp (seconds, UTC), inclusive. Defaults to 00:00 UTC today; if only end_time is sent, defaults to 24h before it.
end_time	optional	Window end as a unix timestamp (seconds, UTC), exclusive. Defaults to start_time + 24h. The window may span at most 24 hours — pick any day boundary in any timezone.
league	optional	Filter by league id.
status	optional	all \| scheduled \| live \| finished. Defaults to all. "live" returns every in-play match right now, regardless of date.
include	optional	Comma list of odds \| events \| stats — expands each fixture with the Bet365 market lines (paid plans), the event timeline, and the in-play statistics, in the same shapes as the per-fixture endpoints. Caps per_page at 50.
esports	optional	true \| false. Defaults to false (real football only); true returns esoccer (e-football) matches instead.
lang	optional	Localize team & league names (21 languages besides English, e.g. zh-cn, ja, es, de, pt). Missing translations fall back to English.
page, per_page	optional	Pagination (per_page max 100; 50 with include; 500 with status=live, so one page holds every live match).

Example

GET /v1/fixtures

curl https://api.5dollarfootballapi.com/v1/fixtures
  -H "Authorization: Bearer fb_live_your_key"

{
  "success": 1,
  "data": [
    {
      "id": 197590518,
      "league": { "id": 43659, "name": "USA USL Cup" },
      "teams": { "home": { "id": 51386, "name": "Birmingham Legion FC" }, "away": { "id": 58558, "name": "Tulsa" } },
      "kickoff_utc": "2026-07-12T00:00:00+00:00",
      "kickoff_ts": 1783814400,
      "status": "finished",
      "goals": { "home": 3, "away": 1 },
      "corners": { "home": 13, "away": 4 },
      "cards": { "home": { "yellow": 1, "red": 0 }, "away": { "yellow": 4, "red": 0 } },
      "odds": {
        "1x2": { "opening": { "home": 1.53, "draw": 3.75, "away": 5.0 }, "closing": { "home": 1.18, "draw": 5.5, "away": 15.0 }, "inplay": null },
        "asian_handicap": { "opening": -0.25, "closing": -0.5, "inplay": -1.0 },
        "goal_line": { "opening": 2.5, "closing": 2.75, "inplay": 3.0 },
        "corner_line": { "opening": 9.5, "closing": 10, "inplay": 10.5 },
        "corner_asian": { "opening": 0, "closing": -0.5, "inplay": null },
        "card_line": { "opening": 4.5, "closing": 5, "inplay": null },
        "card_asian": { "opening": 0, "closing": 0, "inplay": null },
        "asian_handicap_half": { "closing": -0.25, "inplay": null },
        "goal_line_half": { "closing": 1.25, "inplay": 1.5 },
        "corner_line_half": { "closing": 4.5, "inplay": 5 }
      },
      "statistics": {
        "attacks": { "home": 24, "away": 30 },
        "dangerous_attacks": { "home": 11, "away": 14 },
        "shots_on_target": { "home": 3, "away": 5 },
        "shots_off_target": { "home": 4, "away": 2 },
        "possession": { "home": 51, "away": 49 },
        "first_half": {
          "attacks": { "home": 15, "away": 18 },
          "dangerous_attacks": { "home": 6, "away": 8 },
          "shots_on_target": { "home": 1, "away": 2 },
          "shots_off_target": { "home": 2, "away": 0 },
          "possession": { "home": 50, "away": 50 }
        }
      },
      "events": [
        { "type": "goal", "minute": 20, "team": "away", "count": 1 },
        { "type": "corner", "minute": 23, "team": "home", "count": 1 },
        { "type": "yellow_card", "minute": 41, "team": "home", "count": 1 },
        { "type": "period_score", "minute": null, "team": null, "period": "first_half", "score": { "home": 0, "away": 1 } },
        { "type": "missed_penalty", "minute": 55, "team": "away" },
        { "type": "substitution", "minute": 63, "team": "away", "player_in": "R. Silva", "player_out": "J. Costa" },
        { "type": "red_card", "minute": 78, "team": "away" },
        { "type": "period_score", "minute": null, "team": null, "period": "second_half", "score": { "home": 3, "away": 1 } }
      ]
    }
  ],
  "pagination": { "page": 1, "per_page": 50, "count": 1, "has_more": true }
}

// odds / statistics / events appear only with ?include=odds,events,stats

Need a key? Create a free account — a working key is issued instantly, no card required.

← All documentation Pricing →