fixtures

List 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.

get/fixtures

Request

  • Base URL: https://api.5dollarfootballapi.com/v1
  • URL: https://api.5dollarfootballapi.com/v1/fixtures
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

start_timeinteger

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_timeinteger

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.

leagueinteger

Filter by league id.

statusstring

all | scheduled | live | finished | unknown. Defaults to all. "live" returns every in-play match right now, regardless of date; "unknown" the rows the feed lost (see Fixture status).

includestring

Comma list of odds | events | stats — expands each fixture with the Bet365 market lines (odds is Pro and above on lists; Free reads the same markets per fixture at /v1/fixtures/{id}/odds), the event timeline, and the in-play statistics, in the same shapes as the per-fixture endpoints. Caps per_page at 50. odds_full: Only with status=live, and part of the Business plan (contact us to switch it on). Adds an odds_full block to every in-play match: all eleven Bet365 markets with their opening, closing and in-play prices, in the same shape as the bet365 entry of /v1/fixtures/{id}/odds (the fixed goal lines ladder stays there) — one call prices every live match instead of one call per match. A market with no price yet keeps its line with null prices. It refreshes every few seconds and can be combined with odds, events and stats. Anywhere else it is a 400 invalid_include; on other plans, a 403 insufficient_plan.

esportsboolean

true | false. Defaults to false (real football only); true returns esoccer (e-football) matches instead. Esoccer requires the Ultra plan — other plans get a 403 insufficient_plan.

langstring

Localize team & league names (21 languages besides English, e.g. zh-cn, ja, es, de, pt). Missing translations fall back to English.

pageinteger

Pagination (per_page max 100; 50 with include; 500 with status=live, so one page holds every live match).

per_pageinteger

Pagination (per_page max 100; 50 with include; 500 with status=live, so one page holds every live match).

Response

Success

success1 required

Changes

No recorded changes to this operation across all 1 revision of this API.