API Reference
Every endpoint, sport by sport
The same resource model repeats across every sport we cover: fixtures, results, standings, statistics and odds.
Core
Fixtures & Results
Schedules and full-time results for every league.
Core
Standings
League tables, updated after every match.
Core
Statistics
Team and player statistics, current season.
Core
Odds
Pre-match and live odds, normalized across books.
Resource: Fixtures
GET /v1/{sport}/fixtures
Upcoming fixtures for a given league, team or date range.
GET /v1/football/fixtures?league=premier-league
{
"league": "Premier League",
"fixtures": 10,
"next_kickoff": "2026-08-30T15:00:00Z"
}
{
"league": "Premier League",
"fixtures": 10,
"next_kickoff": "2026-08-30T15:00:00Z"
}
Resource: Live Scores
GET /v1/{sport}/matches/live
In-play matches with the current score, clock and latest event.
GET /v1/football/matches/live
{
"match": "Man City vs Arsenal",
"score": "2-1",
"minute": 67
}
{
"match": "Man City vs Arsenal",
"score": "2-1",
"minute": 67
}
Resource: Odds
GET /v1/{sport}/odds
Pre-match and live odds, normalized to a consistent format across sportsbooks.
GET /v1/football/odds?match_id=884213
{
"market": "1X2",
"home": 1.91,
"draw": 3.40,
"away": 4.20
}
{
"market": "1X2",
"home": 1.91,
"draw": 3.40,
"away": 4.20
}
Errors
Standard HTTP status codes
Every error returns a consistent JSON body alongside the standard status code.
400 Bad Request — malformed parameter
401 Unauthorized — missing or invalid API key
429 Too Many Requests — rate limit exceeded
500 Internal Error — retry with backoff
401 Unauthorized — missing or invalid API key
429 Too Many Requests — rate limit exceeded
500 Internal Error — retry with backoff
See Also
Related pages
Explore more of the developer platform.
Get Started
Start free. Upgrade when you need enterprise SLAs.
Self-serve API keys for developers today — dedicated infrastructure, custom feeds and SLAs when you're ready.