Football API
API Playground
Test the live football endpoints here with editable parameters and see the exact response. The explorer uses a server-side free-tier token, so you can try requests without creating an account first.
Standings
League table as JSON or an embeddable HTML widget.
GET /Standings/{league}/{season}
GET /Standings/{league}/{division}/{season}
GET /Standings/{league}/{season}/format/widget
GET /Standings/{league}/{division}/{season}/format/widget
| Parameter | Required | Notes |
|---|---|---|
league | Yes | Competition name, URL encoded. |
division | No | Use only when the competition has divisions. |
season | Yes | Current format is slug-style, for example 2025-26. |
format | No | json or widget. Default is json. |
theme | No | Widget only. default, minimal, or dark. |
accent | No | Widget only. Hex colour, for example #0064ff. |
style | No | Widget only. inline or none. |
Proxy request
cURL
Run the request to see the response.
Fixtures
Filter fixtures by date, team, competition, season, status, and output format.
GET /Fixtures
GET /Fixtures/{key}/{value}/...
| Parameter | Required | Notes |
|---|---|---|
from | No | Date filter in yyyy-MM-dd format. Supports today. |
to | No | Date filter end in yyyy-MM-dd format. Supports today. |
competition | No | Competition name. |
division | No | Division name. |
season | No | Competition season, for example 2025-26. |
team | No | Matches where the team is either home or away. |
status | No | active or an exact match such as HT, FT, PENS, AET, Awarded, Scheduled, Suspended, Match Postponed, or Match Cancelled. |
format | No | json, xml, or widget. Default is json. |
theme | No | Widget only. default, minimal, or dark. |
accent | No | Widget only. Hex colour, for example #0064ff. |
style | No | Widget only. inline or none. |
Active includes in-play minute statuses plus HT and FT. All other options map directly to the underlying MATCH_STATUS value. Competition fields support type-ahead suggestions.
Proxy request
cURL
Run the request to see the response.
Competitions
List competitions, optionally filtered by country.
GET /Competitions
GET /Competitions/{key}/{value}/...
| Parameter | Required | Notes |
|---|---|---|
country | No | Filters competitions to a country name such as England. |
Proxy request
cURL
Run the request to see the response.
Head-to-Head
Recent-form 1/X/2 prediction using each team's last 5 completed matches in a competition season.
GET /HeadToHead/{league}/{season}/{team1}/{team2}/Predictions
GET /HeadToHead/{league}/{division}/{season}/{team1}/{team2}/Predictions
GET /HeadToHead/{league}/{season}/{team1}/{team2}/Predictions/format/widget
GET /HeadToHead/{league}/{division}/{season}/{team1}/{team2}/Predictions/format/widget
| Parameter | Required | Notes |
|---|---|---|
league | Yes | Competition name, URL encoded. |
division | No | Use only when the competition has divisions. |
season | Yes | Competition season, for example 2025-26. |
team1 | Yes | First team in the comparison. This maps to prediction label 1. |
team2 | Yes | Second team in the comparison. This maps to prediction label 2. |
format | No | json or widget. Default is json. |
theme | No | Widget only. default, minimal, or dark. |
accent | No | Widget only. Hex colour, for example #0064ff. |
style | No | Widget only. inline or none. |
This prediction uses only the last 5 completed matches for each side in the selected competition season and returns a simple 1 / X / 2 split.
Proxy request
cURL
Run the request to see the response.
Competition Seasons
Find season rows for a competition and season description.
GET /CompetitionSeasons
| Parameter | Required | Notes |
|---|---|---|
competition | No | Competition name filter. |
description | No | Season description filter, for example 2025-26. |
Proxy request
cURL
Run the request to see the response.
Competition Teams
Return the teams for a competition season, with optional division filtering.
GET /Competition
| Parameter | Required | Notes |
|---|---|---|
competition | No | Competition name filter. |
division | No | Optional division filter for competitions with divisions. |
description | No | Season description filter, for example 2025-26. |
Proxy request
cURL
Run the request to see the response.