### GET /getavailableleagues Source: https://api.openligadb.de/swagger/v1/swagger.json Retrieves a list of all available leagues. ```APIDOC ## GET /getavailableleagues ### Description Retrieves a list of all available leagues. ### Method GET ### Endpoint /getavailableleagues ### Response #### Success Response (200) - **items** (array) - An array of League objects. #### Response Example ```json [ { "id": 1, "name": "Bundesliga", "type": "Football", "iconUrl": "..." } ] ``` ``` -------------------------------- ### GET /getmatchdata/{leagueShortcut}/{leagueSeason} Source: https://api.openligadb.de/swagger/v1/swagger.json Retrieves all matches for a given league and season. ```APIDOC ## GET /getmatchdata/{leagueShortcut}/{leagueSeason} ### Description Gibt eine Struktur von Spieldaten aller Spiele der übergebenen Liga (leagueShortcut) für die gesamte übergebene Saison (leagueSeason) zurueck. ### Method GET ### Endpoint /getmatchdata/{leagueShortcut}/{leagueSeason} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - der Shortcut der Liga, z.B. 'bl1' für die erste Bundesliga - **leagueSeason** (integer) - Required - die Saison der Liga, z.B. 2019 für die Saison 2019/2020 ### Response #### Success Response (200) - **Match** (array) - Description of the Match schema items ``` -------------------------------- ### GET /getbltable/{leagueShortcut}/{leagueSeason} Source: https://api.openligadb.de/swagger/v1/swagger.json Returns the league table for the specified league and season. ```APIDOC ## GET /getbltable/{leagueShortcut}/{leagueSeason} ### Description Returns the league table for the specified league and season. ### Method GET ### Endpoint /getbltable/{leagueShortcut}/{leagueSeason} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - **leagueSeason** (integer) - Required ### Response #### Success Response (200) - **Array** (Table) - The league table data. ``` -------------------------------- ### GET /getnextmatchbyleagueshortcut/{leagueShortcut} Source: https://api.openligadb.de/swagger/v1/swagger.json Retrieves the next upcoming match for a given league shortcut. ```APIDOC ## GET /getnextmatchbyleagueshortcut/{leagueShortcut} ### Description Gibt das nächste folgende Spiel des übergebenen LigaShortcuts zurueck. ### Method GET ### Endpoint /getnextmatchbyleagueshortcut/{leagueShortcut} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - Der Liga-Shortcut ### Response #### Success Response (200) - **Match** (object) - The details of the next match. #### Response Example { "example": "{\"matchId\": 12345, \"leagueId\": 1, \"team1Id\": 10, \"team2Id\": 11, \"matchDateTime\": \"2023-11-01T15:30:00Z\", \"goalsTeam1\": null, \"goalsTeam2\": null}" ``` -------------------------------- ### GET /getavailablesports Source: https://api.openligadb.de/swagger/v1/swagger.json Retrieves a list of all available sports. ```APIDOC ## GET /getavailablesports ### Description Retrieves a list of all available sports. ### Method GET ### Endpoint /getavailablesports ### Response #### Success Response (200) - **items** (array) - An array of Sport objects. #### Response Example ```json [ { "id": 1, "name": "Football", "iconUrl": "..." } ] ``` ``` -------------------------------- ### GET /getlastmatchbyleagueshortcut/{leagueShortcut} Source: https://api.openligadb.de/swagger/v1/swagger.json Retrieves the last completed match for a given league shortcut. ```APIDOC ## GET /getlastmatchbyleagueshortcut/{leagueShortcut} ### Description Gibt das letzte Spiel des übergebenen LigaShortcuts zurueck. ### Method GET ### Endpoint /getlastmatchbyleagueshortcut/{leagueShortcut} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - Der Liga-Shortcut ### Response #### Success Response (200) - **Match** (object) - The details of the last match. #### Response Example { "example": "{\"matchId\": 12344, \"leagueId\": 1, \"team1Id\": 8, \"team2Id\": 9, \"matchDateTime\": \"2023-10-29T17:30:00Z\", \"goalsTeam1\": 2, \"goalsTeam2\": 1}" ``` -------------------------------- ### GET /getmatchdata/{matchId} Source: https://api.openligadb.de/swagger/v1/swagger.json Retrieves detailed information for a specific match by its ID. ```APIDOC ## GET /getmatchdata/{matchId} ### Description Retrieves detailed information for a specific match by its ID. ### Method GET ### Endpoint /getmatchdata/{matchId} ### Parameters #### Path Parameters - **matchId** (integer) - Required - The unique identifier of the match. ### Response #### Success Response (200) - **match** (object) - A Match object containing details of the specified match. #### Response Example ```json { "matchId": 123, "leagueId": 1, "homeTeamName": "Team A", "awayTeamName": "Team B", "score": "2-1", "matchDateTime": "2023-10-27T18:30:00Z" } ``` ``` -------------------------------- ### GET /getmatchdata/{leagueShortcut}/{leagueSeason} Source: https://api.openligadb.de/swagger/v1/swagger.json Gibt eine Struktur von Spieldaten aller Spiele der übergebenen Liga (leagueShortcut) für die gesamte übergebene Saison (leagueSeason) zurueck. ```APIDOC ## GET /getmatchdata/{leagueShortcut}/{leagueSeason} ### Description Gibt eine Struktur von Spieldaten aller Spiele der übergebenen Liga (leagueShortcut) für die gesamte übergebene Saison (leagueSeason) zurueck. ### Method GET ### Endpoint /getmatchdata/{leagueShortcut}/{leagueSeason} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - The shortcut identifier for the league. - **leagueSeason** (integer) - Required - The season identifier for the league. ### Response #### Success Response (200) - **matches** (array) - An array of Match objects for the specified league and season. #### Response Example ```json [ { "matchId": 789, "leagueId": 1, "homeTeamName": "Team E", "awayTeamName": "Team F", "score": "3-0", "matchDateTime": "2023-10-27T18:30:00Z" } ] ``` ``` -------------------------------- ### GET /getgoalgetters/{leagueShortcut}/{leagueSeason} Source: https://api.openligadb.de/swagger/v1/swagger.json Retrieves a list of goal getters for the specified league and season. ```APIDOC ## GET /getgoalgetters/{leagueShortcut}/{leagueSeason} ### Description Retrieves a list of goal getters for the specified league and season. ### Method GET ### Endpoint /getgoalgetters/{leagueShortcut}/{leagueSeason} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - **leagueSeason** (integer) - Required ### Response #### Success Response (200) - **Array** (GoalGetter) - A list of goal getters for the requested league and season. ``` -------------------------------- ### GET /getcurrentgroup/{leagueShortcut} Source: https://api.openligadb.de/swagger/v1/swagger.json Retrieves the current group (e.g., matchday) for a given league shortcut. ```APIDOC ## GET /getcurrentgroup/{leagueShortcut} ### Description Gibt die aktuelle Group (entspricht z.B. bei der Fussball-Bundesliga dem 'Spieltag') des als Parameter zu übergebenden leagueShortcuts (z.B. 'bl1') aus. Der aktuelle Spieltag wird jeweils zur Hälfte der Zeit zwischen dem letzten Spiel des letzten Spieltages und dem ersten Spiel des nächsten Spieltages erhöht. ### Method GET ### Endpoint /getcurrentgroup/{leagueShortcut} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - der Shortcut der Liga, z.B. 'bl1' für die erste Bundesliga ### Response #### Success Response (200) - **Group** (object) - Details of the current group. ``` -------------------------------- ### GET /getavailablegroups/{leagueShortcut}/{leagueSeason} Source: https://api.openligadb.de/swagger/v1/swagger.json Lists the available groups (e.g., matchdays, preliminary rounds, finals) for a given league and season. ```APIDOC ## GET /getavailablegroups/{leagueShortcut}/{leagueSeason} ### Description Eine Liste der Spiel-Einteilungen (Spieltag, Vorrunde, Finale, ...) der als Parameter zu übergebenden Liga + Saison ### Method GET ### Endpoint /getavailablegroups/{leagueShortcut}/{leagueSeason} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - The shortcut of the league. - **leagueSeason** (string) - Required - The season of the league. ``` -------------------------------- ### GET /getmatchdata/{teamId1}/{teamId2} Source: https://api.openligadb.de/swagger/v1/swagger.json Retrieves matches between two specified teams. ```APIDOC ## GET /getmatchdata/{teamId1}/{teamId2} ### Description Gibt eine Struktur von Matches zurück, bei welchen die als Parameter übergebenen Teams gegeneinander spielen. ### Method GET ### Endpoint /getmatchdata/{teamId1}/{teamId2} ### Parameters #### Path Parameters - **teamId1** (integer) - Required - die Id des ersten Teams - **teamId2** (integer) - Required - die Id des anderen Teams ### Response #### Success Response (200) - **Match** (array) - Description of the Match schema items ``` -------------------------------- ### GET /getresultinfos/{leagueId} Source: https://api.openligadb.de/swagger/v1/swagger.json Retrieves the configured result types for a given league ID. ```APIDOC ## GET /getresultinfos/{leagueId} ### Description Gibt die für diese Liga konfigurierten Ergebnistypen zurück! ### Method GET ### Endpoint /getresultinfos/{leagueId} ### Parameters #### Path Parameters - **leagueId** (integer) - Required - Id der Liga, z.B. '4500' für die erste Bundesliga 2021/2022 ### Response #### Success Response (200) - **ResultInfo** (object) - The configured result types for the league. ``` -------------------------------- ### GET /getavailableteams/{leagueShortcut}/{leagueSeason} Source: https://api.openligadb.de/swagger/v1/swagger.json Retrieves a list of teams participating in the specified league and season. ```APIDOC ## GET /getavailableteams/{leagueShortcut}/{leagueSeason} ### Description Retrieves a list of teams participating in the specified league and season. ### Method GET ### Endpoint /getavailableteams/{leagueShortcut}/{leagueSeason} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - **leagueSeason** (integer) - Required ### Response #### Success Response (200) - **Array** (Team) - A list of teams for the requested league and season. ``` -------------------------------- ### GET /getmatchdata/{leagueShortcut}/{leagueSeason}/{groupOrderId} Source: https://api.openligadb.de/swagger/v1/swagger.json Retrieves match data for a specific league, season, and group order. ```APIDOC ## GET /getmatchdata/{leagueShortcut}/{leagueSeason}/{groupOrderId} ### Description Retrieves match data for a specific league, season, and group order. ### Method GET ### Endpoint /getmatchdata/{leagueShortcut}/{leagueSeason}/{groupOrderId} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - The shortcut identifier for the league. - **leagueSeason** (integer) - Required - The season identifier for the league. Defaults to 0. - **groupOrderId** (integer) - Required - The group order identifier. Defaults to 0. ### Response #### Success Response (200) - **matches** (array) - An array of Match objects for the specified criteria. #### Response Example ```json [ { "matchId": 456, "leagueId": 1, "homeTeamName": "Team C", "awayTeamName": "Team D", "score": "1-1", "matchDateTime": "2023-10-27T18:30:00Z" } ] ``` ``` -------------------------------- ### GET /getlastmatchbyleagueteam/{leagueId}/{teamId} Source: https://api.openligadb.de/swagger/v1/swagger.json Retrieves the last preceding match for a given league and team. ```APIDOC ## GET /getlastmatchbyleagueteam/{leagueId}/{teamId} ### Description Gibt das letzte zurückliegende Spiel der übergebenen Liga (leagueId) des übergebenen Teams (teamId) zurueck. ### Method GET ### Endpoint /getlastmatchbyleagueteam/{leagueId}/{teamId} ### Parameters #### Path Parameters - **leagueId** (integer) - Required - die Id der Liga - **teamId** (integer) - Required - die Id des Teams ### Response #### Success Response (200) - **Match** (object) - Details of the last match. ``` -------------------------------- ### GET /getnextmatchbyleagueteam/{leagueId}/{teamId} Source: https://api.openligadb.de/swagger/v1/swagger.json Retrieves the next upcoming match for a specific team within a given league. ```APIDOC ## GET /getnextmatchbyleagueteam/{leagueId}/{teamId} ### Description Gibt das nächste folgende Spiel der übergebenen Liga (leagueId) des übergebenen Teams (teamId) zurueck. ### Method GET ### Endpoint /getnextmatchbyleagueteam/{leagueId}/{teamId} ### Parameters #### Path Parameters - **leagueId** (integer) - Required - die Id der Liga - **teamId** (integer) - Required - die Id des Teams ### Response #### Success Response (200) - **Match** (object) - The details of the next match. #### Response Example { "example": "{\"matchId\": 12345, \"leagueId\": 1, \"team1Id\": 10, \"team2Id\": 11, \"matchDateTime\": \"2023-11-01T15:30:00Z\", \"goalsTeam1\": null, \"goalsTeam2\": null}" ``` -------------------------------- ### GET /getmatchdata/{leagueShortcut}/{leagueSeason}/{teamFilterstring} Source: https://api.openligadb.de/swagger/v1/swagger.json Retrieves all matches for a specific team within a given league and season. ```APIDOC ## GET /getmatchdata/{leagueShortcut}/{leagueSeason}/{teamFilterstring} ### Description Gibt eine Struktur von Spieldaten aller Spiele eines Teams der übergebenen Liga (leagueShortcut) für die gesamte übergebene Saison (leagueSeason) für das im "teamFilterstring" übergebene Team zurueck. Hier reicht ein Teil des Vereinsnamen aus. ### Method GET ### Endpoint /getmatchdata/{leagueShortcut}/{leagueSeason}/{teamFilterstring} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - der Shortcut der Liga, z.B. 'bl1' für die erste Bundesliga - **leagueSeason** (integer) - Required - die Saison der Liga, z.B. 2019 für die Saison 2019/2020 - **teamFilterstring** (string) - Required - Name bzw. Teil des Namens eines Teams ### Response #### Success Response (200) - **Match** (array) - Description of the Match schema items ``` -------------------------------- ### GET /getlastchangedate/{leagueShortcut}/{leagueSeason}/{groupOrderId} Source: https://api.openligadb.de/swagger/v1/swagger.json Retrieves the last modification date for match data of a specific league, season, and matchday. ```APIDOC ## GET /getlastchangedate/{leagueShortcut}/{leagueSeason}/{groupOrderId} ### Description Gibt ein DateTime-Objekt der letzten Änderung der Daten der übergebenen Liga (leagueShortcut) für die übergebene Saison (leagueSeason) für den übergebenen Spieltag (groupOrderId) zurueck. ### Method GET ### Endpoint /getlastchangedate/{leagueShortcut}/{leagueSeason}/{groupOrderId} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - der Shortcut der Liga, z.B. 'bl1' für die erste Bundesliga - **leagueSeason** (integer) - Required - die Saison der Liga, z.B. 2019 für die Saison 2019/2020 - **groupOrderId** (integer) - Required - beim Fußball der Spieltag, z.B. 1 ### Response #### Success Response (200) - **date-time** (string) - The last modification date and time. #### Response Example "2023-10-27T10:00:00Z" ``` -------------------------------- ### OpenLigaDB API Endpoints Source: https://api.openligadb.de This section details the various endpoints available in the OpenLigaDB API for retrieving sports league data. ```APIDOC ## API Endpoints ### Get Available Leagues ### Description Retrieves a list of available leagues. ### Method GET ### Endpoint /getavailableleagues ### Get Available Sports ### Description Retrieves a list of available sports. ### Method GET ### Endpoint /getavailablesports ### Get Match Data by Match ID ### Description Retrieves match data for a specific match ID. ### Method GET ### Endpoint /getmatchdata/{matchId} ### Parameters #### Path Parameters - **matchId** (string) - Required - The ID of the match. ### Get Match Data by League, Season, and Group Order ID ### Description Retrieves match data for a specific league, season, and group order ID. ### Method GET ### Endpoint /getmatchdata/{leagueShortcut}/{leagueSeason}/{groupOrderId} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - The shortcut of the league. - **leagueSeason** (string) - Required - The season of the league. - **groupOrderId** (string) - Required - The order ID of the group. ### Get Match Data by League and Season ### Description Returns a structure of match data for all games of the passed league (leagueShortcut) for the entire passed season (leagueSeason). ### Method GET ### Endpoint /getmatchdata/{leagueShortcut}/{leagueSeason} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - The shortcut of the league. - **leagueSeason** (string) - Required - The season of the league. ### Get Match Data by League, Season, and Team Filterstring ### Description Returns a structure of match data for all games of a team of the passed league (leagueShortcut) for the entire passed season (leagueSeason) for the team passed in the "teamFilterstring". A part of the team name is sufficient here. ### Method GET ### Endpoint /getmatchdata/{leagueShortcut}/{leagueSeason}/{teamFilterstring} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - The shortcut of the league. - **leagueSeason** (string) - Required - The season of the league. - **teamFilterstring** (string) - Required - A filter string for the team name. ### Get Match Data by Team IDs ### Description Returns a structure of matches in which the teams passed as parameters play against each other. ### Method GET ### Endpoint /getmatchdata/{teamId1}/{teamId2} ### Parameters #### Path Parameters - **teamId1** (string) - Required - The ID of the first team. - **teamId2** (string) - Required - The ID of the second team. ### Get Last Change Date ### Description Returns a DateTime object of the last change of the data of the passed league (leagueShortcut) for the passed season (leagueSeason) for the passed matchday (groupOrderId). ### Method GET ### Endpoint /getlastchangedate/{leagueShortcut}/{leagueSeason}/{groupOrderId} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - The shortcut of the league. - **leagueSeason** (string) - Required - The season of the league. - **groupOrderId** (string) - Required - The order ID of the group (matchday). ### Get Next Match by League and Team ### Description Returns the next upcoming match of the passed league (leagueId) for the passed team (teamId). ### Method GET ### Endpoint /getnextmatchbyleagueteam/{leagueId}/{teamId} ### Parameters #### Path Parameters - **leagueId** (string) - Required - The ID of the league. - **teamId** (string) - Required - The ID of the team. ### Get Next Match by League Shortcut ### Description Returns the next upcoming match of the passed league shortcut. ### Method GET ### Endpoint /getnextmatchbyleagueshortcut/{leagueShortcut} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - The shortcut of the league. ### Get Last Match by League Shortcut ### Description Returns the last played match of the passed league shortcut. ### Method GET ### Endpoint /getlastmatchbyleagueshortcut/{leagueShortcut} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - The shortcut of the league. ### Get Last Match by League and Team ### Description Returns the last played match of the passed league (leagueId) for the passed team (teamId). ### Method GET ### Endpoint /getlastmatchbyleagueteam/{leagueId}/{teamId} ### Parameters #### Path Parameters - **leagueId** (string) - Required - The ID of the league. - **teamId** (string) - Required - The ID of the team. ### Get Current Group ### Description Returns the current group (e.g., 'matchday' for the German Football Bundesliga) of the league shortcut passed as a parameter (e.g., 'bl1'). The current matchday is incremented halfway between the last match of the last matchday and the first match of the next matchday. ### Method GET ### Endpoint /getcurrentgroup/{leagueShortcut} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - The shortcut of the league. ### Get Result Infos ### Description Returns the result types configured for this league. ### Method GET ### Endpoint /getresultinfos/{leagueId} ### Parameters #### Path Parameters - **leagueId** (string) - Required - The ID of the league. ### Get Available Groups ### Description A list of the matchday divisions (matchday, preliminary round, final, ...) of the league + season passed as parameters. ### Method GET ### Endpoint /getavailablegroups/{leagueShortcut}/{leagueSeason} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - The shortcut of the league. - **leagueSeason** (string) - Required - The season of the league. ### Get Goal Getters ### Description A list of the matchday divisions (matchday, preliminary round, final, ...) of the league + season passed as parameters. ### Method GET ### Endpoint /getgoalgetters/{leagueShortcut}/{leagueSeason} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - The shortcut of the league. - **leagueSeason** (string) - Required - The season of the league. ### Get Available Teams ### Description A list of teams of the league + season passed as parameters. ### Method GET ### Endpoint /getavailableteams/{leagueShortcut}/{leagueSeason} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - The shortcut of the league. - **leagueSeason** (string) - Required - The season of the league. ### Get BL Table ### Description Returns the league table. ### Method GET ### Endpoint /getbltable/{leagueShortcut}/{leagueSeason} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - The shortcut of the league. - **leagueSeason** (string) - Required - The season of the league. ### Get Group Table ### Description Returns the group table. ### Method GET ### Endpoint /getgrouptable/{leagueShortcut}/{leagueSeason} ### Parameters #### Path Parameters - **leagueShortcut** (string) - Required - The shortcut of the league. - **leagueSeason** (string) - Required - The season of the league. ### Get Matches by Team Filterstring ### Description Retrieves matches based on a team filterstring. ### Method GET ### Endpoint /getmatchesbyteam/{teamFilterstring}/{weekCountPast}/{weekCountFuture} ### Parameters #### Path Parameters - **teamFilterstring** (string) - Required - A filter string for the team name. - **weekCountPast** (integer) - Required - The number of past weeks to include. - **weekCountFuture** (integer) - Required - The number of future weeks to include. ### Get Matches by Team ID ### Description Retrieves matches based on a team ID. ### Method GET ### Endpoint /getmatchesbyteamid/{teamId}/{weekCountPast}/{weekCountFuture} ### Parameters #### Path Parameters - **teamId** (string) - Required - The ID of the team. - **weekCountPast** (integer) - Required - The number of past weeks to include. - **weekCountFuture** (integer) - Required - The number of future weeks to include. ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.