{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"02a461b0-9e48-4bee-9e11-7cb1cef5c1e2","name":"BBL V2","description":"The API documentation for the core sport data and statistics of the easyCredit Basketball Bundesliga\n\n**Please only use the DEV-Server for testing.**\n\n> **The Prod-URL is monitored by bad behavior analysis and OWASP Core-Set, it is also rate limited.**  \n**Disrespect will be banned for 24h** \n  \n\nif you need an API key or got problems contact [kulok@easyCredit-BBL.de](https://mailto:kulok@easyCredit-BBL.de)\n\nAll Endpoins can also be triggered via an socket.io connection.\n\nSocket.IO is a library that enables **low-latency**, **bidirectional** and **event-based** communication between a client and a server.\n\n<img src=\"https://content.pstmn.io/6ec9c5d9-193f-400e-b0fb-7fb1cfe2c698/aW1hZ2UucG5n\" width=\"840\" height=\"131\">\n\nIt is built on top of the [WebSocket](https://en.wikipedia.org/wiki/WebSocket) protocol and provides additional guarantees like fallback to HTTP long-polling or automatic reconnection.\n\nWebSocket is a communication protocol which provides a full-duplex and low-latency channel between the server and the browser. More information can be found [here](https://en.wikipedia.org/wiki/WebSocket).\n\nThere are several Socket.IO server implementations available:\n\n- JavaScript (Node.js): [https://socket.io/docs/v4/](https://socket.io/docs/v4/)\n    \n- JavaScript (Deno): [https://github.com/socketio/socket.io-deno](https://github.com/socketio/socket.io-deno)\n    \n- Java: [https://github.com/mrniko/netty-socketio](https://github.com/mrniko/netty-socketio)\n    \n- Java: [https://github.com/trinopoty/socket.io-server-java](https://github.com/trinopoty/socket.io-server-java)\n    \n- Python: [https://github.com/miguelgrinberg/python-socketio](https://github.com/miguelgrinberg/python-socketio)\n    \n- Golang: [https://github.com/googollee/go-socket.io](https://github.com/googollee/go-socket.io)\n    \n\nAnd client implementations in most major languages:\n\n- JavaScript (which can be run either in the browser, in Node.js or in React Native)\n    \n\nThe event for the EventEmitter is named after the endpoint, and the parameters are contained within a JSON object. The response will be embedded in an object that also includes status information.\n\nLet's look at a simple example for the `/teams/:seasonId` endpoint:\n\n``` javascript\nconst socket = io('https://api.basketball-bundesliga.de', {\n    extraHeaders: {\n        'x-api-key': \"xxx\"\n    }\n})\nsocket.emit('teams', {\"seasonId\": 2024}, function(result) {\n    console.log(result)\n}\n\n ```\n\nthis will be the answer:\n\n``` json\n{\n    \"status\": \"success\",\n    \"statusCode\": 200,\n    \"data\": [\n        {\n            \"id\": 486,\n            \"name\": \"FC Bayern München Basketball\",\n            \"shortname\": \"München\",\n            \"TLC\": \"FCB\"\n        },\n        {\n            \"id\": 413,\n            \"name\": \"ALBA BERLIN\",\n            \"shortname\": \"Berlin\",\n            \"TLC\": \"BER\"\n        },\n        ...\n    ]\n}\n\n ```\n\n# Glossary\n\nTo minimize data transmitted and allow for a universal data model, we have chosen to use abbreviations for some values. Such values are usually written in capital letters.\n\n| abbrev | caption | description |\n| --- | --- | --- |\n| NUM | Shirt Number | The number on the players trikot general or at the specific game |\n| PTS | Points | all Points including 3PM, 2PM and FTM |\n| 2PM | 2 Point Field Goals Made | The number of 2 point field goals that a player or team has made |\n| 3PM | 3 Point Field Goals Made | The number of 3 point field goals that a player or team has made |\n| FGM | Field Goals Made | The number of 2 and 3 points field goals that a player or team has made that fit the specified criteria |\n| FTM | Free Throws Made | free throws that a player has made while on the court |\n| 2PA | 2 Point Field Goals Attempted | The number of 2 point field goals that a player or team has attempted |\n| 3PA | 3 Point Field Goals Attempted | The number of 3 point field goals that a player or team has attempted |\n| FGA | Field Goals Attempted | The number of field goals that a player or team has attempted |\n| FTA | Free Throws Attempted | free throws attempted that a player has attempted while on the court |\n| 2P% | 2 Point Field Goal Percentage | The percentage of 2 point field goal attempts that a player makes |\n| 3P% | 3 Point Field Goal Percentage | The percentage of 3 point field goal attempts that a player makes |\n| FG% | Field Goals Percentage | The percentage of field goals attempts that a player makes |\n| FT% | Free Throws Percentage | The percentage of free throws attempts that a player makes |\n| OREB | Offensive Rebounds | Offensive Rebounds that a player has while on the court |\n| DREB | Defensive Rebounds | Defensive Rebounds that a player has while on the court |\n| REB | Rebounds | Rebounds that a player has while on the court |\n| AST | Assists | The number of assists -- passes that lead directly to a made basket -- by A player |\n| STL | Steals | steals that a player has while on the court |\n| TOV | Turnovers | turnovers that a player has while on the court |\n| BL | Blocks | blocks that a player has while on the court |\n| FOUL | Fouls | fouls that a player has while on the court |\n| EFF | Efficiency | efficiency that a player has while on the court |\n| PM | Plus-Minus | The point differential when a player or team is on the floor |\n| DBLDBL | Double Double | A double-double is when a player records double digits in two of the five main statistical categories—points, rebounds, assists, steals, or blocks—in a single game. |\n| TBLDBL | Triple Double | A triple-double is when a player records double digits in three of the five main statistical categories—points, rebounds, assists, steals, or blocks—in a single game. |\n| FOULR | fouls received | number of fouls a player received |\n| \\*-G | all stats per game |  |\n| SP | Seconds Played |  |\n| GP | Games Played |  |\n| S5 | Starting Five |  |\n| PTSM | Points Made |  |\n| PTSA | Points Against |  |","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"37720364","team":6396813,"collectionId":"02a461b0-9e48-4bee-9e11-7cb1cef5c1e2","publishedId":"2sAYdkFTJJ","public":true,"publicUrl":"https://api-docs.basketball.scb.world","privateUrl":"https://go.postman.co/documentation/37720364-02a461b0-9e48-4bee-9e11-7cb1cef5c1e2","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"system_default","themes":[{"name":"dark","logo":"https://content.pstmn.io/0e441e53-2c57-46b0-8b7f-1fcbc45b5afb/U3BvcnRzTWFuLnBuZw==","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":"https://content.pstmn.io/0e441e53-2c57-46b0-8b7f-1fcbc45b5afb/U3BvcnRzTWFuLnBuZw==","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2025-03-07T06:56:20.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/0e441e53-2c57-46b0-8b7f-1fcbc45b5afb/U3BvcnRzTWFuLnBuZw==","logoDark":"https://content.pstmn.io/0e441e53-2c57-46b0-8b7f-1fcbc45b5afb/U3BvcnRzTWFuLnBuZw=="}},"statusCode":200},"environments":[{"name":"dev","id":"050a19ee-1e3f-4ec4-833d-27c189b25349","owner":"42898757","values":[{"key":"Server","value":"api.bbl.scb.world","enabled":true,"type":"default"},{"key":"apiKey","value":"","enabled":true,"type":"secret"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/4e74a9a02855e06ec31c8282a30d7b7b03eb947afa59f70cbf0b3e15c358f4e4","favicon":"https://res.cloudinary.com/postman/image/upload/v1742156580/team/2f396be29e475fd7d6a6d2a387438095.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"dev","value":"42898757-050a19ee-1e3f-4ec4-833d-27c189b25349"}],"canonicalUrl":"https://api-docs.basketball.scb.world/view/metadata/2sAYdkFTJJ"}