OpenLigaDB API

Beginner's Pick Sports & Fitness / No Auth Required Beginner HTTPS CORS
Free to Use Varies (check documentation)
77 B
Measured Score 0 50 100 Reachability 30/30 Speed 5/20 Security 15/15 Developer XP 12/20 Reliability 15/15 TESTED 2026-07-23

Overview

OpenLigaDB is a free, crowd-sourced API providing sports league results, schedules, and standings for various leagues primarily German football (Bundesliga) but also others. No API key is needed, so you can fetch current matchday results with a simple GET request. It is a friendly entry point for sports data beginners thanks to its clean JSON responses.

Beginner Tip

Start with the /getmatchdata/{leagueShortcut}/{leagueSeason}/{group} endpoint to retrieve results for a specific matchday. Use bl1 as the league shortcut for Bundesliga 1st division.

Available Data

match scores and results
team standings
player statistics
schedule and fixtures

Example Response

JSON Response
{
  "match_id": 4521,
  "home_team": "Team A",
  "away_team": "Team B",
  "score": {
    "home": 2,
    "away": 1
  },
  "status": "Full Time",
  "date": "2025-01-15",
  "league": "Premier League"
}

Field Reference

matchID Unique identifier for the match
matchDateTimeUTC Match kick-off time in UTC ISO 8601 format
team1.teamName Name of the home team
team2.teamName Name of the away team
matchResults[].pointsTeam1 Goals scored by the home team at this result stage
matchIsFinished True if the match has been completed

Implementation Example

Request
const url = "https://www.openligadb.de/";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

404 Not Found Incorrect league shortcut or season year
Check the available leagues at /getavailableleagues and use the correct leagueShortcut value
Null matchResults array Requesting future matches that have no results yet
Only scores for completed matches are available; filter by the matchIsFinished field
Unexpected data structure Different leagues may return slightly different field sets
Always check for the presence of optional fields before accessing them

Measured Score Breakdown

Live HTTP request to the API endpoint

Reachability 30/30
Speed 5/20
Security 15/15
Developer XP 12/20
Reliability 15/15
Endpoint Response Time 1214ms

Fully tested on Jul 23, 2026

Technical Specifications

Auth No Auth
HTTPS REQUIRED
CORS YES
Category Sports & Fitness
Difficulty Beginner
Verified: 2026-04-04

Similar APIs

View All →