OpenLigaDB API

⭐ Beginner's Pick Sports & Fitness / No Auth Required Beginner HTTPS CORS
Free to Use Varies (check documentation)

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

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

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 15/20
🔒 Security 15/15
🛠 Developer XP 20/20
✓ Reliability 7/15
Response Time 469ms

Fully tested on Apr 5, 2026

Technical Specifications

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

Similar APIs

View All →