{ "info": { "_postman_id": "ea70d8df-c528-59e4-bdf0-ccd3a4c61bbc", "name": "SportAPI - football data API", "description": "Fixtures, live scores, events, line-ups, match stats, standings, teams, squads and players.\n\nAuthenticate with your API key in the `X-Api-Key` header (create one at https://sportapi.ai/dashboard). Each plan has a daily limit that resets at 00:00 UTC; the Free plan also has a monthly limit of 14,000 requests per calendar month (UTC) from 1 November 2026. Responses carry `X-RateLimit-*` headers (and `X-RateLimit-Month-*` on the Free plan). Successful GETs carry an `ETag`: send it in `If-None-Match` to get `304 Not Modified` when nothing changed.\n\nTimes: `kickoff_utc` and `updated_at` are UTC; `date` and `datetime` are Central European time (CET/CEST).\n\nLive score pushes: WebSocket `wss://sportapi.ai/ws?key=YOUR_API_KEY` (see https://sportapi.ai/docs#websocket).\n\nSet the `apiKey` collection variable to your key from https://sportapi.ai/dashboard. Generated from the OpenAPI spec v1.1.0.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "version": "1.1.0" }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-Api-Key", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://sportapi.ai/api" }, { "key": "apiKey", "value": "YOUR_API_KEY" } ], "item": [ { "name": "Fixtures", "item": [ { "name": "Fixtures on a date", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/fixtures/date/:date", "host": [ "{{baseUrl}}" ], "path": [ "fixtures", "date", ":date" ], "variable": [ { "key": "date", "value": "2026-10-10", "description": "YYYY-MM-DD" } ] }, "description": "Fixtures on a date" }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/fixtures/date/:date", "host": [ "{{baseUrl}}" ], "path": [ "fixtures", "date", ":date" ], "variable": [ { "key": "date", "value": "2026-10-10", "description": "YYYY-MM-DD" } ] }, "description": "Fixtures on a date" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"date\": \"2026-10-10\",\n \"data\": [\n {\n \"id\": 13596176,\n \"home_id\": 311,\n \"away_id\": 352,\n \"date\": \"2026-10-10\",\n \"datetime\": \"2026-10-10 13:30:00\",\n \"kickoff_utc\": \"2026-10-10T11:30:00Z\",\n \"updated_at\": \"2026-10-11T01:43:09Z\",\n \"home_score\": 2,\n \"away_score\": 1,\n \"result\": 1,\n \"status\": \"FT\",\n \"minute\": null,\n \"stage\": \"\",\n \"league_id\": 24,\n \"league_name\": \"Premier League\",\n \"league_geo\": \"GB-ENG\",\n \"league_zone\": \"England\",\n \"home_team\": \"Arsenal\",\n \"home_short\": \"Arsenal\",\n \"home_logo\": \"espn-359.png\",\n \"home_geo\": \"\",\n \"away_team\": \"Leeds United\",\n \"away_short\": \"Leeds\",\n \"away_logo\": \"espn-357.png\",\n \"away_geo\": \"\",\n \"penalty_home\": null,\n \"penalty_away\": null,\n \"winner\": \"home\"\n }\n ]\n}" } ] }, { "name": "Fixture with teams, venue, coaches and events", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/fixtures/:id", "host": [ "{{baseUrl}}" ], "path": [ "fixtures", ":id" ], "variable": [ { "key": "id", "value": "13596176", "description": "Fixture ID" } ] }, "description": "Fixture with teams, venue, coaches and events" }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/fixtures/:id", "host": [ "{{baseUrl}}" ], "path": [ "fixtures", ":id" ], "variable": [ { "key": "id", "value": "13596176", "description": "Fixture ID" } ] }, "description": "Fixture with teams, venue, coaches and events" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"fixture\": {\n \"id\": 13596176,\n \"home_id\": 311,\n \"away_id\": 352,\n \"date\": \"2026-10-10\",\n \"datetime\": \"2026-10-10 13:30:00\",\n \"kickoff_utc\": \"2026-10-10T11:30:00Z\",\n \"updated_at\": \"2026-10-11T01:43:09Z\",\n \"home_score\": 2,\n \"away_score\": 1,\n \"ht_home\": 0,\n \"ht_away\": 0,\n \"result\": 1,\n \"status\": \"FT\",\n \"minute\": null,\n \"stage\": \"\",\n \"league_id\": 24,\n \"league_name\": \"Premier League\",\n \"league_geo\": \"GB-ENG\",\n \"league_zone\": \"England\",\n \"home_team\": \"Arsenal\",\n \"home_short\": \"Arsenal\",\n \"home_logo\": \"espn-359.png\",\n \"home_geo\": \"\",\n \"home_stadium\": \"Emirates Stadium\",\n \"home_city\": \"London\",\n \"home_coach\": \"Mikel Arteta\",\n \"home_founded\": 1886,\n \"away_team\": \"Leeds United\",\n \"away_short\": \"Leeds\",\n \"away_logo\": \"espn-357.png\",\n \"away_geo\": \"\",\n \"away_stadium\": \"Elland Road\",\n \"away_city\": \"Leeds\",\n \"away_coach\": \"Daniel Farke\",\n \"away_founded\": 1919,\n \"penalty_home\": null,\n \"penalty_away\": null,\n \"winner\": \"home\",\n \"events\": [\n {\n \"event_type\": \"goal\",\n \"team_side\": \"away\",\n \"player_name\": \"J. Justin\",\n \"minute\": \"55'\",\n \"extra_info\": \"Goal\"\n },\n {\n \"event_type\": \"yellow_card\",\n \"team_side\": \"away\",\n \"player_name\": \"A. Tanaka\",\n \"minute\": \"36'\",\n \"extra_info\": null\n }\n ]\n }\n}" } ] }, { "name": "Match events: goals, cards, substitutions", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/fixtures/:id/events", "host": [ "{{baseUrl}}" ], "path": [ "fixtures", ":id", "events" ], "variable": [ { "key": "id", "value": "13596176", "description": "Fixture ID" } ] }, "description": "Match events: goals, cards, substitutions" }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/fixtures/:id/events", "host": [ "{{baseUrl}}" ], "path": [ "fixtures", ":id", "events" ], "variable": [ { "key": "id", "value": "13596176", "description": "Fixture ID" } ] }, "description": "Match events: goals, cards, substitutions" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"fixture_id\": 13596176,\n \"data\": [\n {\n \"id\": 19194470,\n \"event_type\": \"goal\",\n \"team_side\": \"away\",\n \"player_name\": \"J. Justin\",\n \"player_urn\": \"urn:bbc:sportsdata:football:player:s-6icypdqtfk2k81ax0i49j5xpl\",\n \"minute\": \"55'\",\n \"extra_info\": \"Goal\"\n },\n {\n \"id\": 18933975,\n \"event_type\": \"yellow_card\",\n \"team_side\": \"away\",\n \"player_name\": \"A. Tanaka\",\n \"player_urn\": \"urn:bbc:sportsdata:football:player:s-28ucbvor6b0yxreoieehudfc9\",\n \"minute\": \"36'\",\n \"extra_info\": null\n }\n ]\n}" } ] }, { "name": "Team match statistics", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/fixtures/:id/stats", "host": [ "{{baseUrl}}" ], "path": [ "fixtures", ":id", "stats" ], "variable": [ { "key": "id", "value": "13596176", "description": "Fixture ID" } ] }, "description": "Team match statistics" }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/fixtures/:id/stats", "host": [ "{{baseUrl}}" ], "path": [ "fixtures", ":id", "stats" ], "variable": [ { "key": "id", "value": "13596176", "description": "Fixture ID" } ] }, "description": "Team match statistics" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"fixture_id\": 13596176,\n \"available\": true,\n \"data\": {\n \"home\": {\n \"shots\": 13,\n \"shots_on_target\": 6,\n \"shots_off_target\": 7,\n \"fouls\": 12,\n \"total_passes\": 512,\n \"pass_accuracy\": 85.3,\n \"tackles\": 12,\n \"tackle_success\": 66.7,\n \"saves\": 4,\n \"yellow_cards\": 1\n },\n \"away\": {\n \"shots\": 11,\n \"shots_on_target\": 5,\n \"shots_off_target\": 6,\n \"fouls\": 20,\n \"total_passes\": 356,\n \"pass_accuracy\": 78.9,\n \"tackles\": 10,\n \"tackle_success\": 60,\n \"saves\": 4,\n \"yellow_cards\": 4\n }\n }\n}" } ] }, { "name": "Starting XI and substitutes", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/fixtures/:id/lineups", "host": [ "{{baseUrl}}" ], "path": [ "fixtures", ":id", "lineups" ], "variable": [ { "key": "id", "value": "13596176", "description": "Fixture ID" } ] }, "description": "Starting XI and substitutes" }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/fixtures/:id/lineups", "host": [ "{{baseUrl}}" ], "path": [ "fixtures", ":id", "lineups" ], "variable": [ { "key": "id", "value": "13596176", "description": "Fixture ID" } ] }, "description": "Starting XI and substitutes" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"fixture_id\": 13596176,\n \"available\": true,\n \"data\": {\n \"home\": {\n \"starters\": [\n {\n \"name\": \"David Raya\",\n \"position\": \"Goalkeeper\",\n \"shirt\": 1,\n \"is_captain\": false,\n \"mins_played\": 90\n },\n {\n \"name\": \"B. White\",\n \"position\": \"Defender\",\n \"shirt\": 4,\n \"is_captain\": false,\n \"mins_played\": 63\n }\n ],\n \"subs\": [\n {\n \"name\": \"P. Hincapié\",\n \"position\": \"Substitute\",\n \"shirt\": 5,\n \"is_captain\": false,\n \"mins_played\": 8\n }\n ]\n },\n \"away\": {\n \"starters\": [\n {\n \"name\": \"J. Trafford\",\n \"position\": \"Goalkeeper\",\n \"shirt\": 1,\n \"is_captain\": false,\n \"mins_played\": 90\n },\n {\n \"name\": \"J. Bogle\",\n \"position\": \"Midfielder\",\n \"shirt\": 2,\n \"is_captain\": false,\n \"mins_played\": 86\n }\n ],\n \"subs\": [\n {\n \"name\": \"S. Longstaff\",\n \"position\": \"Substitute\",\n \"shirt\": 8,\n \"is_captain\": false,\n \"mins_played\": 0\n }\n ]\n }\n }\n}" } ] }, { "name": "Head-to-head matches between two teams", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/fixtures/h2h/:team1/:team2", "host": [ "{{baseUrl}}" ], "path": [ "fixtures", "h2h", ":team1", ":team2" ], "variable": [ { "key": "team1", "value": "311", "description": "Team ID" }, { "key": "team2", "value": "312", "description": "Team ID" } ] }, "description": "Head-to-head matches between two teams" }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/fixtures/h2h/:team1/:team2", "host": [ "{{baseUrl}}" ], "path": [ "fixtures", "h2h", ":team1", ":team2" ], "variable": [ { "key": "team1", "value": "311", "description": "Team ID" }, { "key": "team2", "value": "312", "description": "Team ID" } ] }, "description": "Head-to-head matches between two teams" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"team1\": 311,\n \"team2\": 312,\n \"data\": [\n {\n \"id\": 604,\n \"home_id\": 311,\n \"away_id\": 312,\n \"date\": \"2026-01-08\",\n \"home_score\": 0,\n \"away_score\": 0,\n \"result\": 0,\n \"status\": \"FT\",\n \"home_team\": \"Arsenal\",\n \"away_team\": \"Liverpool\",\n \"league_name\": \"Premier League\"\n },\n {\n \"id\": 577,\n \"home_id\": 312,\n \"away_id\": 311,\n \"date\": \"2025-08-31\",\n \"home_score\": 1,\n \"away_score\": 0,\n \"result\": 1,\n \"status\": \"FT\",\n \"home_team\": \"Liverpool\",\n \"away_team\": \"Arsenal\",\n \"league_name\": \"Premier League\"\n }\n ]\n}" } ] } ] }, { "name": "Teams", "item": [ { "name": "Team with recent and upcoming matches and its competitions", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/teams/:id", "host": [ "{{baseUrl}}" ], "path": [ "teams", ":id" ], "variable": [ { "key": "id", "value": "311", "description": "Team ID" } ] }, "description": "Team with recent and upcoming matches and its competitions" }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/teams/:id", "host": [ "{{baseUrl}}" ], "path": [ "teams", ":id" ], "variable": [ { "key": "id", "value": "311", "description": "Team ID" } ] }, "description": "Team with recent and upcoming matches and its competitions" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"team\": {\n \"id\": 311,\n \"name\": \"Arsenal\",\n \"short_name\": \"Arsenal\",\n \"league_id\": 24,\n \"geo\": \"GB-ENG\",\n \"country\": \"England\",\n \"city\": \"London\",\n \"coach_name\": \"Mikel Arteta\",\n \"stadium_name\": \"Emirates Stadium\",\n \"founded_year\": 1886,\n \"logo_file\": \"espn-359.png\"\n },\n \"matches\": [\n {\n \"id\": 16096707,\n \"home_id\": 311,\n \"away_id\": 10165,\n \"date\": \"2026-11-07\",\n \"home_score\": null,\n \"away_score\": null,\n \"result\": null,\n \"status\": \"Scheduled\",\n \"league_id\": 24,\n \"league_name\": \"Premier League\",\n \"home_team\": \"Arsenal\",\n \"away_team\": \"Hull City\"\n },\n {\n \"id\": 15868670,\n \"home_id\": 162,\n \"away_id\": 311,\n \"date\": \"2026-11-04\",\n \"home_score\": null,\n \"away_score\": null,\n \"result\": null,\n \"status\": \"Scheduled\",\n \"league_id\": 18,\n \"league_name\": \"UEFA Champions League\",\n \"home_team\": \"Slavia Prague\",\n \"away_team\": \"Arsenal\"\n }\n ],\n \"leagues\": [\n {\n \"id\": 24,\n \"name\": \"Premier League\"\n },\n {\n \"id\": 18,\n \"name\": \"UEFA Champions League\"\n }\n ]\n}" } ] }, { "name": "Team logo image (a placeholder shield when there is none)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/teams/:id/logo", "host": [ "{{baseUrl}}" ], "path": [ "teams", ":id", "logo" ], "variable": [ { "key": "id", "value": "311", "description": "Team ID" } ] }, "description": "Team logo image (a placeholder shield when there is none)" }, "response": [] }, { "name": "Team by slug, with league, results, upcoming matches and squad", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/teams/slug/:slug", "host": [ "{{baseUrl}}" ], "path": [ "teams", "slug", ":slug" ], "variable": [ { "key": "slug", "value": "arsenal", "description": "Team slug" } ] }, "description": "Team by slug, with league, results, upcoming matches and squad" }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/teams/slug/:slug", "host": [ "{{baseUrl}}" ], "path": [ "teams", "slug", ":slug" ], "variable": [ { "key": "slug", "value": "arsenal", "description": "Team slug" } ] }, "description": "Team by slug, with league, results, upcoming matches and squad" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"team\": {\n \"id\": 311,\n \"name\": \"Arsenal\",\n \"short_name\": \"Arsenal\",\n \"slug\": \"arsenal\",\n \"country\": \"England\",\n \"city\": \"London\",\n \"geo\": \"GB-ENG\",\n \"founded_year\": 1886,\n \"coach_name\": \"Mikel Arteta\",\n \"stadium_name\": \"Emirates Stadium\",\n \"logo_file\": \"espn-359.png\",\n \"league\": {\n \"id\": 24,\n \"name\": \"Premier League\",\n \"slug\": \"premier-league\"\n }\n },\n \"results\": [\n {\n \"id\": 13596176,\n \"date\": \"2026-10-10\",\n \"home_score\": 2,\n \"away_score\": 1,\n \"status\": \"FT\",\n \"result\": 1,\n \"home_team\": \"Arsenal\",\n \"home_slug\": \"arsenal\",\n \"away_team\": \"Leeds United\",\n \"away_slug\": \"leeds-united\",\n \"league_name\": \"Premier League\",\n \"league_slug\": \"premier-league\"\n }\n ],\n \"upcoming\": [\n {\n \"id\": 13596702,\n \"date\": \"2026-10-13\",\n \"datetime\": \"2026-10-13 21:00:00\",\n \"status\": \"Scheduled\",\n \"home_team\": \"Arsenal\",\n \"home_slug\": \"arsenal\",\n \"away_team\": \"Lille\",\n \"away_slug\": \"lille\",\n \"league_name\": \"UEFA Champions League\"\n }\n ],\n \"squad\": [\n {\n \"full_name\": \"David Raya\",\n \"position\": \"Goalkeeper\",\n \"jersey_number\": 1,\n \"nationality\": \"ES\",\n \"slug\": \"david-raya\"\n },\n {\n \"full_name\": \"Kepa Arrizabalaga\",\n \"position\": \"Goalkeeper\",\n \"jersey_number\": 13,\n \"nationality\": \"ES\",\n \"slug\": \"kepa-arrizabalaga\"\n }\n ]\n}" } ] }, { "name": "Current squad", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/teams/:id/squad", "host": [ "{{baseUrl}}" ], "path": [ "teams", ":id", "squad" ], "variable": [ { "key": "id", "value": "311", "description": "Team ID" } ] }, "description": "Current squad" }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/teams/:id/squad", "host": [ "{{baseUrl}}" ], "path": [ "teams", ":id", "squad" ], "variable": [ { "key": "id", "value": "311", "description": "Team ID" } ] }, "description": "Current squad" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"squad\": [\n {\n \"id\": 4904,\n \"full_name\": \"David Raya\",\n \"position\": \"Goalkeeper\",\n \"jersey_number\": 1,\n \"nationality\": \"ES\",\n \"date_of_birth\": \"1995-09-15\",\n \"height\": null,\n \"weight\": null\n },\n {\n \"id\": 4903,\n \"full_name\": \"Kepa Arrizabalaga\",\n \"position\": \"Goalkeeper\",\n \"jersey_number\": 13,\n \"nationality\": \"ES\",\n \"date_of_birth\": \"1994-10-03\",\n \"height\": null,\n \"weight\": null\n }\n ]\n}" } ] }, { "name": "Trophy history", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/teams/:id/trophies", "host": [ "{{baseUrl}}" ], "path": [ "teams", ":id", "trophies" ], "variable": [ { "key": "id", "value": "311", "description": "Team ID" } ] }, "description": "Trophy history" }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/teams/:id/trophies", "host": [ "{{baseUrl}}" ], "path": [ "teams", ":id", "trophies" ], "variable": [ { "key": "id", "value": "311", "description": "Team ID" } ] }, "description": "Trophy history" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"trophies\": [\n {\n \"year\": 1994,\n \"position\": 1,\n \"tournament_id\": 26,\n \"name\": \"1994 UEFA Cup Winners' Cup Final\",\n \"short_name\": null,\n \"type\": \"domestic_league\",\n \"country\": null\n },\n {\n \"year\": 1993,\n \"position\": 1,\n \"tournament_id\": 24,\n \"name\": \"1987 Football League Cup Final\",\n \"short_name\": null,\n \"type\": \"domestic_league\",\n \"country\": null\n }\n ]\n}" } ] } ] }, { "name": "Standings", "item": [ { "name": "Leagues that have a table", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/standings/leagues", "host": [ "{{baseUrl}}" ], "path": [ "standings", "leagues" ] }, "description": "Leagues that have a table" }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/standings/leagues", "host": [ "{{baseUrl}}" ], "path": [ "standings", "leagues" ] }, "description": "Leagues that have a table" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": [\n {\n \"id\": 24,\n \"name\": \"Premier League\",\n \"slug\": \"premier-league\",\n \"zone\": \"England\",\n \"geo\": \"GB-ENG\"\n },\n {\n \"id\": 1,\n \"name\": \"Spanish La Liga\",\n \"slug\": \"spanish-la-liga\",\n \"zone\": \"Spain\",\n \"geo\": \"ES\"\n }\n ]\n}" } ] }, { "name": "League table with form (last 6 matches, oldest first)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/standings/:league", "host": [ "{{baseUrl}}" ], "path": [ "standings", ":league" ], "variable": [ { "key": "league", "value": "24", "description": "League ID or slug; with a slug the response also has `league`" } ] }, "description": "League table with form (last 6 matches, oldest first)" }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/standings/:league", "host": [ "{{baseUrl}}" ], "path": [ "standings", ":league" ], "variable": [ { "key": "league", "value": "24", "description": "League ID or slug; with a slug the response also has `league`" } ] }, "description": "League table with form (last 6 matches, oldest first)" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": [\n {\n \"position\": 1,\n \"team\": {\n \"id\": 324,\n \"name\": \"Manchester City\",\n \"short_name\": \"Man City\",\n \"slug\": \"manchester-city\",\n \"logo\": \"espn-382.png\"\n },\n \"played\": 5,\n \"won\": 5,\n \"draw\": 0,\n \"lost\": 0,\n \"goals_for\": 13,\n \"goals_against\": 5,\n \"goal_difference\": 8,\n \"points\": 15,\n \"form\": [\n {\n \"result\": \"W\",\n \"date\": \"2026-09-13\",\n \"home_team\": \"Manchester United\",\n \"away_team\": \"Manchester City\",\n \"home_score\": 0,\n \"away_score\": 1,\n \"is_home\": false\n },\n {\n \"result\": \"W\",\n \"date\": \"2026-09-20\",\n \"home_team\": \"Manchester City\",\n \"away_team\": \"Sunderland\",\n \"home_score\": 5,\n \"away_score\": 3,\n \"is_home\": true\n }\n ]\n },\n {\n \"position\": 2,\n \"team\": {\n \"id\": 311,\n \"name\": \"Arsenal\",\n \"short_name\": \"Arsenal\",\n \"slug\": \"arsenal\",\n \"logo\": \"espn-359.png\"\n },\n \"played\": 6,\n \"won\": 5,\n \"draw\": 0,\n \"lost\": 1,\n \"goals_for\": 10,\n \"goals_against\": 5,\n \"goal_difference\": 5,\n \"points\": 15,\n \"form\": [\n {\n \"result\": \"L\",\n \"date\": \"2026-09-19\",\n \"home_team\": \"Brighton & Hove Albion\",\n \"away_team\": \"Arsenal\",\n \"home_score\": 3,\n \"away_score\": 0,\n \"is_home\": false\n },\n {\n \"result\": \"W\",\n \"date\": \"2026-10-10\",\n \"home_team\": \"Arsenal\",\n \"away_team\": \"Leeds United\",\n \"home_score\": 2,\n \"away_score\": 1,\n \"is_home\": true\n }\n ]\n }\n ]\n}" } ] } ] }, { "name": "Leagues", "item": [ { "name": "All leagues grouped by country, with coverage", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/leagues", "host": [ "{{baseUrl}}" ], "path": [ "leagues" ] }, "description": "All leagues grouped by country, with coverage" }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/leagues", "host": [ "{{baseUrl}}" ], "path": [ "leagues" ] }, "description": "All leagues grouped by country, with coverage" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": [\n {\n \"country\": \"England\",\n \"geo\": \"GB-ENG\",\n \"leagues\": [\n {\n \"id\": 53,\n \"name\": \"Championship\",\n \"geo\": \"GB-ENG\",\n \"domestic\": 1,\n \"has_standings\": true,\n \"has_fixtures\": true,\n \"fixtures_count\": 737,\n \"teams_count\": 24\n },\n {\n \"id\": 26,\n \"name\": \"English Community Shield\",\n \"geo\": \"GB-ENG\",\n \"domestic\": 1,\n \"has_standings\": true,\n \"has_fixtures\": true,\n \"fixtures_count\": 2,\n \"teams_count\": 0\n }\n ]\n }\n ]\n}" } ] }, { "name": "League with teams, upcoming fixtures and recent results", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/leagues/:id", "host": [ "{{baseUrl}}" ], "path": [ "leagues", ":id" ], "variable": [ { "key": "id", "value": "24", "description": "League ID" } ] }, "description": "League with teams, upcoming fixtures and recent results" }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/leagues/:id", "host": [ "{{baseUrl}}" ], "path": [ "leagues", ":id" ], "variable": [ { "key": "id", "value": "24", "description": "League ID" } ] }, "description": "League with teams, upcoming fixtures and recent results" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"id\": 24,\n \"name\": \"Premier League\",\n \"geo\": \"GB-ENG\",\n \"country\": \"England\",\n \"domestic\": 1,\n \"teams\": [\n {\n \"id\": 370,\n \"name\": \"AFC Bournemouth\",\n \"logo_file\": \"espn-349.png\"\n },\n {\n \"id\": 311,\n \"name\": \"Arsenal\",\n \"logo_file\": \"espn-359.png\"\n }\n ],\n \"upcoming_fixtures\": [\n {\n \"id\": 13596518,\n \"date\": \"2026-10-11\",\n \"datetime\": \"2026-10-11 15:00:00\",\n \"home_team\": \"Crystal Palace\",\n \"away_team\": \"Nottingham Forest\"\n }\n ],\n \"recent_results\": [\n {\n \"id\": 13596181,\n \"date\": \"2026-10-10\",\n \"home_team\": \"Manchester United\",\n \"away_team\": \"Tottenham Hotspur\",\n \"home_score\": 1,\n \"away_score\": 1\n }\n ]\n}" } ] }, { "name": "Top scorers (current season)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/leagues/:id/topscorers", "host": [ "{{baseUrl}}" ], "path": [ "leagues", ":id", "topscorers" ], "variable": [ { "key": "id", "value": "24", "description": "League ID" } ], "query": [ { "key": "limit", "value": "20", "description": "Rows to return, 1-100 (default 20)", "disabled": true }, { "key": "season", "value": "", "description": "`all` = every season instead of the current one", "disabled": true } ] }, "description": "Top scorers (current season)" }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/leagues/:id/topscorers", "host": [ "{{baseUrl}}" ], "path": [ "leagues", ":id", "topscorers" ], "variable": [ { "key": "id", "value": "24", "description": "League ID" } ], "query": [ { "key": "limit", "value": "20", "description": "Rows to return, 1-100 (default 20)", "disabled": true }, { "key": "season", "value": "", "description": "`all` = every season instead of the current one", "disabled": true } ] }, "description": "Top scorers (current season)" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"season_from\": \"2026-08-21\",\n \"data\": [\n {\n \"rank\": 1,\n \"player_name\": \"E. Haaland\",\n \"player_urn\": \"urn:bbc:sportsdata:football:player:s-atzboo800gv7gic2rgvgo0kq1\",\n \"team_id\": 324,\n \"team_name\": \"Manchester City\",\n \"goals\": 5,\n \"penalties\": 0\n },\n {\n \"rank\": 1,\n \"player_name\": \"João Pedro\",\n \"player_urn\": \"urn:bbc:sportsdata:football:player:s-eaqqezw2ed1u0tt3zc128mr1m\",\n \"team_id\": 322,\n \"team_name\": \"Chelsea\",\n \"goals\": 5,\n \"penalties\": 0\n }\n ]\n}" } ] }, { "name": "Top assists (current season)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/leagues/:id/topassists", "host": [ "{{baseUrl}}" ], "path": [ "leagues", ":id", "topassists" ], "variable": [ { "key": "id", "value": "24", "description": "League ID" } ], "query": [ { "key": "limit", "value": "20", "description": "Rows to return, 1-100 (default 20)", "disabled": true }, { "key": "season", "value": "", "description": "`all` = every season instead of the current one", "disabled": true } ] }, "description": "Top assists (current season)" }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/leagues/:id/topassists", "host": [ "{{baseUrl}}" ], "path": [ "leagues", ":id", "topassists" ], "variable": [ { "key": "id", "value": "24", "description": "League ID" } ], "query": [ { "key": "limit", "value": "20", "description": "Rows to return, 1-100 (default 20)", "disabled": true }, { "key": "season", "value": "", "description": "`all` = every season instead of the current one", "disabled": true } ] }, "description": "Top assists (current season)" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"season_from\": \"2026-08-21\",\n \"data\": [\n {\n \"rank\": 1,\n \"player_name\": \"A. Semenyo\",\n \"player_urn\": \"\",\n \"team_id\": 324,\n \"team_name\": \"Manchester City\",\n \"assists\": 3\n },\n {\n \"rank\": 1,\n \"player_name\": \"C. Palmer\",\n \"player_urn\": \"\",\n \"team_id\": 322,\n \"team_name\": \"Chelsea\",\n \"assists\": 3\n }\n ]\n}" } ] }, { "name": "Most cards (current season)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/leagues/:id/topcards", "host": [ "{{baseUrl}}" ], "path": [ "leagues", ":id", "topcards" ], "variable": [ { "key": "id", "value": "24", "description": "League ID" } ], "query": [ { "key": "limit", "value": "20", "description": "Rows to return, 1-100 (default 20)", "disabled": true }, { "key": "season", "value": "", "description": "`all` = every season instead of the current one", "disabled": true } ] }, "description": "Most cards (current season)" }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/leagues/:id/topcards", "host": [ "{{baseUrl}}" ], "path": [ "leagues", ":id", "topcards" ], "variable": [ { "key": "id", "value": "24", "description": "League ID" } ], "query": [ { "key": "limit", "value": "20", "description": "Rows to return, 1-100 (default 20)", "disabled": true }, { "key": "season", "value": "", "description": "`all` = every season instead of the current one", "disabled": true } ] }, "description": "Most cards (current season)" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"season_from\": \"2026-08-21\",\n \"data\": [\n {\n \"rank\": 1,\n \"player_name\": \"A. Fatawu\",\n \"player_urn\": \"urn:bbc:sportsdata:football:player:s-6cx5c6bzp1hq6c1vui53mxzx0\",\n \"team_id\": 10158,\n \"team_name\": \"Ipswich Town\",\n \"yellow_cards\": 3,\n \"red_cards\": 1,\n \"total_cards\": 4\n },\n {\n \"rank\": 1,\n \"player_name\": \"V. Janelt\",\n \"player_urn\": \"urn:bbc:sportsdata:football:player:s-9k8gysrsy1a261nhcszo4aoyx\",\n \"team_id\": 366,\n \"team_name\": \"Brentford\",\n \"yellow_cards\": 4,\n \"red_cards\": 0,\n \"total_cards\": 4\n }\n ]\n}" } ] } ] }, { "name": "Players", "item": [ { "name": "Player profile with stats, recent matches and next match", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/players/:slug", "host": [ "{{baseUrl}}" ], "path": [ "players", ":slug" ], "variable": [ { "key": "slug", "value": "bukayo-saka", "description": "Player slug" } ] }, "description": "Player profile with stats, recent matches and next match" }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/players/:slug", "host": [ "{{baseUrl}}" ], "path": [ "players", ":slug" ], "variable": [ { "key": "slug", "value": "bukayo-saka", "description": "Player slug" } ] }, "description": "Player profile with stats, recent matches and next match" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"player\": {\n \"id\": 4928,\n \"full_name\": \"Bukayo Saka\",\n \"slug\": \"bukayo-saka\",\n \"position\": \"Forward\",\n \"nationality\": \"GB-ENG\",\n \"date_of_birth\": \"2001-09-05\",\n \"height\": null,\n \"weight\": null,\n \"photo_url\": null,\n \"jersey_number\": 7,\n \"team_id\": 311\n },\n \"team\": {\n \"id\": 311,\n \"full_name\": \"Arsenal\",\n \"slug\": \"arsenal\",\n \"country\": \"England\",\n \"geo\": \"GB-ENG\",\n \"league_id\": 24\n },\n \"league\": {\n \"id\": 24,\n \"name\": \"Premier League\",\n \"slug\": \"premier-league\"\n },\n \"linked\": false,\n \"career\": null,\n \"season\": null,\n \"rank\": null,\n \"matches\": [],\n \"recent\": [],\n \"next_match\": {\n \"date\": \"2026-10-13\",\n \"datetime\": \"2026-10-13 21:00:00\",\n \"home_team\": \"Arsenal\",\n \"home_slug\": \"arsenal\",\n \"away_team\": \"Lille\",\n \"away_slug\": \"lille\",\n \"league_name\": \"UEFA Champions League\"\n },\n \"squad\": [\n {\n \"full_name\": \"David Raya\",\n \"slug\": \"david-raya\",\n \"position\": \"Goalkeeper\",\n \"jersey_number\": 1\n }\n ]\n}" } ] }, { "name": "Per-match stats and totals by player name and team", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/players/stats?name=Bukayo Saka&team_id=311", "host": [ "{{baseUrl}}" ], "path": [ "players", "stats" ], "query": [ { "key": "name", "value": "Bukayo Saka", "description": "Player name", "disabled": false }, { "key": "team_id", "value": "311", "description": "Team ID", "disabled": false }, { "key": "shirt_number", "value": "", "description": "Optional, tells apart players with similar names", "disabled": true } ] }, "description": "Per-match stats and totals by player name and team" }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/players/stats?name=Bukayo Saka&team_id=311", "host": [ "{{baseUrl}}" ], "path": [ "players", "stats" ], "query": [ { "key": "name", "value": "Bukayo Saka", "description": "Player name", "disabled": false }, { "key": "team_id", "value": "311", "description": "Team ID", "disabled": false }, { "key": "shirt_number", "value": "", "description": "Optional, tells apart players with similar names", "disabled": true } ] }, "description": "Per-match stats and totals by player name and team" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"player\": {\n \"shirt_number\": 7,\n \"position\": \"Forward\",\n \"nationality\": \"GB-ENG\",\n \"team\": {\n \"id\": 311,\n \"name\": \"Arsenal\"\n }\n },\n \"totals\": {\n \"appearances\": 46,\n \"goals\": 12,\n \"assists\": 6,\n \"mins_played\": 2775,\n \"shots_total\": 96,\n \"total_passes\": 957,\n \"tackles\": 42,\n \"saves\": 0\n },\n \"matches\": [\n {\n \"goals\": 0,\n \"assists\": 0,\n \"mins_played\": 90,\n \"shots_total\": 2,\n \"total_passes\": 34,\n \"tackles\": 1,\n \"saves\": 0,\n \"position\": \"Attacking Midfielder\",\n \"shirt_number\": 7,\n \"is_starter\": 1,\n \"date\": \"2026-10-10\",\n \"home_score\": 2,\n \"away_score\": 1,\n \"home_id\": 311,\n \"away_id\": 352,\n \"home_team\": \"Arsenal\",\n \"away_team\": \"Leeds United\",\n \"league_name\": \"Premier League\"\n }\n ]\n}" } ] } ] } ] }