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.
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
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.
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.
Filter by league id.
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).
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.
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.
Localize team & league names (21 languages besides English, e.g. zh-cn, ja, es, de, pt). Missing translations fall back to English.
Pagination (per_page max 100; 50 with include; 500 with status=live, so one page holds every live match).
Pagination (per_page max 100; 50 with include; 500 with status=live, so one page holds every live match).
Response
Success
Changes
No recorded changes to this operation across all 1 revision of this API.