canonical: https://jentic.com/apis/openligadb.de/openligadb

# Openligadb De OpenLigaDB API

OpenLigaDB is a community-maintained free API for sports match data, focused on football (soccer) but also covering other leagues. It exposes leagues, teams, matchdays, fixtures, results, group standings, goal scorers, and statistics, all without authentication. OpenLigaDB aims the service primarily at hobby programmers and names prediction games, statistics applications, and Bundesliga widgets as the project types it suits, all reachable without an API key.

## For AI agents

Look up leagues, fixtures, results, standings, and goal scorers for football and other sports without an API key.

## Scope

Does not handle live in-play odds, betting markets, or video streams - use for free football fixtures, results, and standings only.

## Capabilities

- List the available leagues and seasons covered by OpenLigaDB
- Retrieve all matches for a given league and season, including fixture and result data
- Fetch the next or most recent match for a specific team in a league
- Pull the current group or league standings as a points table
- Look up goal scorers for a specific match or for a season
- Get all teams participating in a league for a given season

## Use cases

### Football Fixture and Results Widget

Build a website widget that shows the upcoming fixtures and latest results for a chosen league. The widget calls GET `/getmatchdata/{leagueShortcut}/{leagueSeason}` to pull the season's fixture list and updates after each matchday. Because OpenLigaDB is free and key-less, the widget can be embedded without provisioning credentials.

Example prompt: Call GET `/getmatchdata/bl1/2025` and return the next 5 fixtures with kickoff time, home team, and away team.

### League Standings Display

Render the current points table for a chosen league using OpenLigaDB's standings endpoint. The response includes points, goal difference, and matches played for each team, suitable for a fan dashboard or a Discord bot. The dataset covers multiple seasons so historical tables are available too.

Example prompt: Fetch the current standings for league 'bl1' and season '2025' and return the top 5 teams with points and goal difference.

### Goal Scorer Leaderboard for a Season

Build a top-scorer leaderboard for a season. GET `/getgoalgetters/{leagueShortcut}/{leagueSeason}` returns each scorer with goalGetterName and goalCount, so the ranking needs no client-side aggregation. For per-match detail, OpenLigaDB also embeds a goals array in each match object, giving goalGetterName and matchMinute for every goal.

Example prompt: Call GET `/getgoalgetters/bl1/2025` and return the top 10 entries by goalCount, each with its goalGetterName.

### AI Agent Sports Data Lookup via Jentic

An agent producing match previews or fan-facing summaries can call OpenLigaDB through Jentic so the operations are discoverable by intent. Because the API takes no credential, wiring it up is just importing the API and calling the operation. The structured response keeps the LLM grounded in real fixtures rather than hallucinated dates.

Example prompt: Use Jentic to search for 'next match for a football team', execute GET `/getnextmatchbyleagueteam/{leagueId}/{teamId}`, and return the kickoff time and opponent name.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/getavailableleagues` | List all available leagues |
| GET | `/getmatchdata/{leagueShortcut}/{leagueSeason}` | Get all matches for a league and season |
| GET | `/getmatchdata/{matchId}` | Get a single match by ID |
| GET | `/getnextmatchbyleagueteam/{leagueId}/{teamId}` | Get the next upcoming match for a team |
| GET | `/getavailableteams/{leagueShortcut}/{leagueSeason}` | Get teams in a league and season |
| GET | `/getavailablegroups/{leagueShortcut}/{leagueSeason}` | Get group or matchday list for a season |

## Key resources

- **Leagues** — List available leagues, sports, and seasons.
- **Matches** — Retrieve fixtures, results, and matchday data by league, season, team, or match ID.
- **Standings** — Get current and historical league or group standings.
- **Statistics** — Pull goal scorer and match statistic data.

## Why Jentic

- **Setup:** Wiring the OpenLigaDB API by hand means assembling its league-shortcut and season path segments correctly and parsing the fixture and result payloads yourself, even though it needs no key. Through Jentic you install once, import the OpenLigaDB API from the API Directory, and your agent calls it with no secret to manage.
- **Permission scoping:** OpenLigaDB is read-only football data with no authentication, and you limit the agent to the operations it needs, such as listing available leagues or fetching match data for a season. The surface has no write operations, so the agent can only read fixtures, results, and standings.
- **Credential handling:** OpenLigaDB needs no credential, so there is no secret to store. Your Jentic One instance still mediates each call so the agent works from a structured operation rather than hand-built URLs.
- **Discovery method:** Agents search Jentic by intent such as 'get the next match for a team' or 'list matchday data for a league', and Jentic returns the matching OpenLigaDB operation with its path parameters so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **API-Football** — API-Football covers a much wider league set with deeper stats, while OpenLigaDB is free and focused on Bundesliga and friends.
- **TheSportsDB API** — TheSportsDB is a multi-sport free database; OpenLigaDB is football-first with deeper Bundesliga match data.
- **balldontlie API** — balldontlie covers NBA basketball; pair with OpenLigaDB to cover both football and basketball in one product.
- **PandaScore API** — PandaScore focuses on esports; OpenLigaDB focuses on traditional football leagues.

## FAQ

### What authentication does the OpenLigaDB API use?

OpenLigaDB does not require authentication; all documented endpoints are publicly callable. Through Jentic the call is still mediated for structured responses, and any future authenticated extension would be vaulted in your Jentic One instance.

### Can I get the next match for a specific team with the OpenLigaDB API?

Yes. GET `/getnextmatchbyleagueteam/{leagueId}/{teamId}` returns the next upcoming fixture for the team in the given league, including kickoff time and opponent.

### What are the rate limits for the OpenLigaDB API?

OpenLigaDB's OpenAPI description declares no rate-limit headers and no throttling response, so a client has no published limit to code against. Treat the community-run service as fair-use: cache league, team, and fixture lists rather than re-fetching them on every request.

### How do I list current standings for a league with the OpenLigaDB API through Jentic?

Search Jentic for 'get league standings', load the standings endpoint with the leagueShortcut and leagueSeason path parameters (for example 'bl1' and '2025'), and execute it. Because the API is unauthenticated, no credentials are required.

### Is the OpenLigaDB API free to use?

Yes. The API requires no key and no credential, so any client can call it without registering. OpenLigaDB is a free community project and states that the data provided through this API is under the Open Database License (ODbL), with further licence information at openligadb.de/lizenz, so check that before redistributing the data in a public product.

### Which sports does the OpenLigaDB API cover?

The primary focus is football (soccer), particularly the Bundesliga and other German leagues, but additional leagues and sports are listed via GET /getavailableleagues and GET /getavailablesports.

### Is there an OpenLigaDB MCP server?

You do not need an MCP server to give your agent OpenLigaDB. Jentic connects it directly from the API Directory: import the OpenLigaDB API and, because the API takes no credential, your agent can call the fixture, standings, and goal scorer operations straight away, without loading another server's tool definitions into its context.

### Can I limit what my agent is allowed to do with the OpenLigaDB API?

Yes. Because Jentic One is self-hosted, you set the rules that decide which OpenLigaDB operations your agent may call, so you can grant only what it needs, such as GET /getavailableleagues for the league list and GET `/getmatchdata/{leagueShortcut}/{leagueSeason}` for season fixtures, while withholding others like GET /getnextmatchbyleagueteam. OpenLigaDB is read-only football data with no authentication and no write operations, so a scoped agent can only read fixtures, results, and standings and can never modify anything. This lets the operator narrow the callable surface to exactly the match, standings, or team lookups a given task requires.