{ "openapi": "3.1.0", "info": { "title": "GOAL API", "version": "1.0.0", "summary": "Football (soccer) data: live scores, fixtures, lineups, standings, odds.", "description": "Football data across 1,000+ competitions. Live scores, fixtures and results, team and player data, league standings, head-to-head records, match lineups and statistics, bookmaker odds and match predictions.\n\nAll endpoints require an API key sent as a bearer token. A free tier is available. Some datasets (odds, predictions) require a paid plan.\n\nLive updates are also available over WebSocket at `wss://api.goal-api.com/ws`, which is not described here because OpenAPI does not model WebSocket sessions.", "contact": { "name": "GOAL API support", "email": "support@goal-api.com", "url": "https://goal-api.com/contact" }, "termsOfService": "https://goal-api.com/terms", "license": { "name": "Proprietary", "url": "https://goal-api.com/terms" } }, "servers": [ { "url": "https://api.goal-api.com/v1", "description": "Production" } ], "externalDocs": { "description": "Full documentation", "url": "https://goal-api.com/documentation" }, "security": [ { "bearerAuth": [] } ], "tags": [ { "name": "Countries", "description": "Countries and their competitions" }, { "name": "Leagues", "description": "Competitions, their teams, tables and fixtures" }, { "name": "Teams", "description": "Clubs, squads, fixtures and form" }, { "name": "Fixtures", "description": "Matches, events, lineups, statistics and odds" }, { "name": "Results", "description": "Completed matches" }, { "name": "Players", "description": "Player profiles and season statistics" }, { "name": "Coaches", "description": "Coaches and their teams" }, { "name": "Standings", "description": "League tables, including home, away and form splits" }, { "name": "Head to head", "description": "Previous meetings between two teams" }, { "name": "Videos", "description": "Match highlights" }, { "name": "Odds", "description": "Bookmaker odds. Requires a paid plan." }, { "name": "Predictions", "description": "Match outcome probabilities. Requires a paid plan." } ], "paths": { "/countries": { "get": { "tags": [ "Countries" ], "summary": "List countries", "parameters": [ { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" }, { "$ref": "#/components/parameters/search" }, { "$ref": "#/components/parameters/isActive" } ], "responses": { "200": { "description": "Countries", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Country" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": [ { "_count": { "leagues": 14 }, "apiId": "227", "createdAt": "2026-07-05T03:00:02.583Z", "id": "cmr77dwnr00m9rx06vqo3t602", "isActive": true, "logo": null, "name": "Africa", "updatedAt": "2026-07-19T22:00:36.748Z" }, { "_count": { "leagues": 5 }, "apiId": "10", "createdAt": "2026-07-05T03:00:02.484Z", "id": "cmr77dwl000l8rx060cv12rio", "isActive": true, "logo": "https://media.goal-api.com/badges/logo_country/10_albania.png", "name": "Albania", "updatedAt": "2026-07-19T22:00:36.748Z" } ], "pagination": { "hasMore": true, "limit": 5, "offset": 0, "total": 184 }, "source": "cache", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getCountries" } }, "/countries/{id}": { "get": { "tags": [ "Countries" ], "summary": "Get a country", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Country id" } ], "responses": { "200": { "description": "Country", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "$ref": "#/components/schemas/Country" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": { "_count": { "leagues": 14 }, "apiId": "227", "createdAt": "2026-07-05T03:00:02.583Z", "id": "cmr77dwnr00m9rx06vqo3t602", "isActive": true, "leagues": [ { "id": "cmr77dwo200mfrx06f5ovri0u", "logo": null, "name": "African Championship U16", "season": "2021" }, { "id": "cmr77dwo200mgrx06gtty84zj", "logo": null, "name": "African Championship U16 Women", "season": "2021" } ], "logo": null, "name": "Africa", "updatedAt": "2026-07-19T22:00:36.748Z" }, "source": "cache", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getCountriesById" } }, "/countries/{id}/leagues": { "get": { "tags": [ "Countries" ], "summary": "Competitions in a country", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Country id" }, { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Competitions", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/League" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "countryId": "cmr77dwnr00m9rx06vqo3t602", "data": [ { "_count": { "fixtures": 0, "teams": 0 }, "apiId": "1058", "country": { "id": "cmr77dwnr00m9rx06vqo3t602", "logo": null, "name": "Africa" }, "countryId": "cmr77dwnr00m9rx06vqo3t602", "countryName": "Africa", "createdAt": "2026-07-05T03:00:02.594Z", "id": "cmr77dwo100mbrx06pyueg8er", "isActive": true, "logo": null, "name": "Africa Champions Cup Women", "popularity": 50, "season": "2019", "updatedAt": "2026-07-19T21:49:56.904Z" }, { "_count": { "fixtures": 0, "teams": 0 }, "apiId": "1056", "country": { "id": "cmr77dwnr00m9rx06vqo3t602", "logo": null, "name": "Africa" }, "countryId": "cmr77dwnr00m9rx06vqo3t602", "countryName": "Africa", "createdAt": "2026-07-05T03:00:02.594Z", "id": "cmr77dwo200mdrx06jb6q1u3e", "isActive": true, "logo": null, "name": "Africa Cup 3x3 Women", "popularity": 50, "season": "2019", "updatedAt": "2026-07-19T21:49:56.904Z" } ], "pagination": { "hasMore": true, "limit": 5, "offset": 0, "total": 14 }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getCountriesByIdLeagues" } }, "/leagues": { "get": { "tags": [ "Leagues" ], "summary": "List competitions, most prominent first", "parameters": [ { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" }, { "$ref": "#/components/parameters/search" }, { "$ref": "#/components/parameters/season" }, { "$ref": "#/components/parameters/isActive" }, { "name": "countryId", "in": "query", "schema": { "type": "string" }, "description": "Filter to one country" } ], "responses": { "200": { "description": "Competitions", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/League" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": [ { "_count": { "fixtures": 32, "teams": 16 }, "apiId": "17", "country": { "id": "cmr77dvh40012rx063gppxouv", "logo": "https://media.goal-api.com/badges/logo_country/2_intl.png", "name": "intl" }, "countryId": "cmr77dvh40012rx063gppxouv", "countryName": "intl", "createdAt": "2026-07-05T03:00:01.059Z", "id": "cmr77dvhg0018rx06z11d3k9z", "isActive": true, "logo": "https://media.goal-api.com/badges/logo_leagues/17_conmebol-copa-america.png", "name": "CONMEBOL Copa America", "popularity": 100, "season": "2024", "updatedAt": "2026-07-19T19:33:02.623Z" }, { "_count": { "fixtures": 769, "teams": 47 }, "apiId": "18", "country": { "id": "cmr77dvh40012rx063gppxouv", "logo": "https://media.goal-api.com/badges/logo_country/2_intl.png", "name": "intl" }, "countryId": "cmr77dvh40012rx063gppxouv", "countryName": "intl", "createdAt": "2026-07-05T03:00:01.059Z", "id": "cmr77dvhg0019rx06c0fx6cwh", "isActive": true, "logo": "https://media.goal-api.com/badges/logo_leagues/18_conmebol-libertadores.png", "name": "CONMEBOL Libertadores", "popularity": 100, "season": "2026", "updatedAt": "2026-07-19T19:33:02.623Z" } ], "pagination": { "hasMore": true, "limit": 15, "offset": 0, "total": 1019 }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getLeagues" } }, "/leagues/{id}": { "get": { "tags": [ "Leagues" ], "summary": "Get a competition", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "League id" } ], "responses": { "200": { "description": "Competition", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "$ref": "#/components/schemas/League" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": { "_count": { "fixtures": 32, "standings": 16, "teams": 16 }, "apiId": "17", "country": { "id": "cmr77dvh40012rx063gppxouv", "logo": "https://media.goal-api.com/badges/logo_country/2_intl.png", "name": "intl" }, "countryId": "cmr77dvh40012rx063gppxouv", "countryName": "intl", "createdAt": "2026-07-05T03:00:01.059Z", "id": "cmr77dvhg0018rx06z11d3k9z", "isActive": true, "logo": "https://media.goal-api.com/badges/logo_leagues/17_conmebol-copa-america.png", "name": "CONMEBOL Copa America", "popularity": 100, "season": "2024", "updatedAt": "2026-07-19T19:33:02.623Z" }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getLeaguesById" } }, "/leagues/{id}/teams": { "get": { "tags": [ "Leagues" ], "summary": "Teams in a competition", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "League id" }, { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Teams", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Team" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": [ { "_count": { "awayFixtures": 32, "homeFixtures": 71, "players": 3 }, "apiId": "511", "badge": "https://media.goal-api.com/badges/511_mexico.jpg", "country": "Mexico", "createdAt": "2026-07-05T04:52:21.460Z", "founded": "1927", "id": "cmr7beces0u8rrx06tlcxs1ni", "isActive": true, "name": "Mexico", "rosterSyncedAt": "2026-08-05T04:08:16.540Z", "updatedAt": "2026-08-05T04:37:35.231Z", "venueAddress": "Calzada de Tlalpan 3665, Coyoacán", "venueCapacity": "106187", "venueCity": "D.F.", "venueName": "Estadio Azteca", "venueSurface": "grass" }, { "_count": { "awayFixtures": 33, "homeFixtures": 31, "players": 29 }, "apiId": "533", "badge": "https://media.goal-api.com/badges/533_peru.jpg", "country": "Peru", "createdAt": "2026-07-05T04:52:21.461Z", "founded": "1922", "id": "cmr7becet0u8srx06iu15uf6q", "isActive": true, "name": "Peru", "rosterSyncedAt": "2026-08-05T04:36:43.619Z", "updatedAt": "2026-08-05T04:36:48.395Z", "venueAddress": "Paseo de la Republica", "venueCapacity": "45574", "venueCity": "Lima", "venueName": "Estadio Nacional de Lima", "venueSurface": "grass" } ], "leagueId": "cmr77dvhg0018rx06z11d3k9z", "pagination": { "hasMore": true, "limit": 5, "offset": 0, "total": 16 }, "source": "cache", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getLeaguesByIdTeams" } }, "/leagues/{id}/standings": { "get": { "tags": [ "Leagues" ], "summary": "League table", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "League id" } ], "responses": { "200": { "description": "Table rows", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Standing" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 16, "data": [ { "awayLeagueD": null, "awayLeagueGA": null, "awayLeagueGF": null, "awayLeagueL": null, "awayLeaguePTS": null, "awayLeaguePlayed": null, "awayLeaguePosition": null, "awayLeagueW": null, "awayPromotion": null, "createdAt": "2026-07-05T07:52:03.630Z", "fkStageKey": "85", "homeLeagueD": null, "homeLeagueGA": null, "homeLeagueGF": null, "homeLeagueL": null, "homeLeaguePTS": null, "homeLeaguePlayed": null, "homeLeaguePosition": null, "homeLeagueW": null, "homePromotion": null, "id": "cmr7htgd13d4brx06r0fosjav", "league": { "id": "cmr77dvhg0018rx06z11d3k9z", "name": "CONMEBOL Copa America", "season": "2024" }, "leagueId": "cmr77dvhg0018rx06z11d3k9z", "leagueRound": "Group A", "overallLeagueD": "0", "overallLeagueGA": "0", "overallLeagueGF": "5", "overallLeagueL": "0", "overallLeaguePTS": "9", "overallLeaguePlayed": "3", "overallLeaguePosition": "1", "overallLeagueW": "3", "overallPromotion": "Promotion - Copa América (Play Offs: Quarter-finals)", "season": null, "stageName": "Group Stage", "team": { "badge": "https://media.goal-api.com/badges/536_argentina.jpg", "country": "Argentina", "id": "cmr7becf20u8zrx06zt8asrlw", "name": "Argentina" }, "teamId": "cmr7becf20u8zrx06zt8asrlw", "teamName": "Argentina", "updatedAt": "2026-07-05T07:52:03.630Z" }, { "awayLeagueD": null, "awayLeagueGA": null, "awayLeagueGF": null, "awayLeagueL": null, "awayLeaguePTS": null, "awayLeaguePlayed": null, "awayLeaguePosition": null, "awayLeagueW": null, "awayPromotion": null, "createdAt": "2026-07-05T07:52:03.630Z", "fkStageKey": "85", "homeLeagueD": null, "homeLeagueGA": null, "homeLeagueGF": null, "homeLeagueL": null, "homeLeaguePTS": null, "homeLeaguePlayed": null, "homeLeaguePosition": null, "homeLeagueW": null, "homePromotion": null, "id": "cmr7htgd23d4frx06u9s2woya", "league": { "id": "cmr77dvhg0018rx06z11d3k9z", "name": "CONMEBOL Copa America", "season": "2024" }, "leagueId": "cmr77dvhg0018rx06z11d3k9z", "leagueRound": "Group B", "overallLeagueD": "0", "overallLeagueGA": "1", "overallLeagueGF": "6", "overallLeagueL": "0", "overallLeaguePTS": "9", "overallLeaguePlayed": "3", "overallLeaguePosition": "1", "overallLeagueW": "3", "overallPromotion": "Promotion - Copa América (Play Offs: Quarter-finals)", "season": null, "stageName": "Group Stage", "team": { "badge": "https://media.goal-api.com/badges/532_venezuela.jpg", "country": "Venezuela", "id": "cmr7becfb0u98rx06n9kbjdhm", "name": "Venezuela" }, "teamId": "cmr7becfb0u98rx06n9kbjdhm", "teamName": "Venezuela", "updatedAt": "2026-07-05T07:52:03.630Z" } ], "leagueId": "cmr77dvhg0018rx06z11d3k9z", "metadata": { "hasMultipleStages": false, "lastUpdated": "2026-07-05T07:52:03.630Z", "stages": null, "totalTeams": 16 }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getLeaguesByIdStandings" } }, "/leagues/{id}/fixtures": { "get": { "tags": [ "Leagues" ], "summary": "Fixtures in a competition", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "League id" }, { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Fixtures", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Fixture" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": [ { "apiId": "407738", "awayTeam": { "badge": "https://media.goal-api.com/badges/535_colombia.jpg", "id": "cmr7becf00u8xrx06mm08zlqn", "name": "Colombia" }, "awayTeamExtraScore": "0", "awayTeamFtScore": "0", "awayTeamHalftimeScore": "0", "awayTeamId": "cmr7becf00u8xrx06mm08zlqn", "awayTeamName": "Colombia", "awayTeamPenaltyScore": null, "awayTeamScore": "0", "awayTeamSystem": "4-3-3", "countryId": "2", "countryLogo": "https://media.goal-api.com/badges/logo_country/2_intl.png", "countryName": "intl", "createdAt": "2026-07-13T18:04:55.300Z", "fkStageKey": "83", "homeTeam": { "badge": "https://media.goal-api.com/badges/536_argentina.jpg", "id": "cmr7becf20u8zrx06zt8asrlw", "name": "Argentina" }, "homeTeamExtraScore": "1", "homeTeamFtScore": "0", "homeTeamHalftimeScore": "0", "homeTeamId": "cmr7becf20u8zrx06zt8asrlw", "homeTeamName": "Argentina", "homeTeamPenaltyScore": null, "homeTeamScore": "1", "homeTeamSystem": "4-4-2", "id": "cmrjj8ek8f5bvo807iofofwrf", "league": { "id": "cmr77dvhg0018rx06z11d3k9z", "logo": "https://media.goal-api.com/badges/logo_leagues/17_conmebol-copa-america.png", "name": "CONMEBOL Copa America", "popularity": 100 }, "leagueId": "cmr77dvhg0018rx06z11d3k9z", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/17_conmebol-copa-america.png", "leagueName": "CONMEBOL Copa America - Final", "leagueYear": "2024", "matchDate": "2024-07-15", "matchLive": "0", "matchReferee": "Raphael Claus", "matchRound": "Final", "matchStadium": "Hard Rock Stadium (Miami Gardens, Florida)", "matchStatus": "AFTER_ET", "matchTime": "02:30", "stageName": "Final", "teamAwayBadge": "https://media.goal-api.com/badges/535_colombia.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/536_argentina.jpg", "updatedAt": "2026-08-05T09:08:41.835Z", "videosCheckedAt": null }, { "apiId": "407737", "awayTeam": { "badge": "https://media.goal-api.com/badges/539_uruguay.jpg", "id": "cmr7becf90u96rx061s4bpzl5", "name": "Uruguay" }, "awayTeamExtraScore": "0", "awayTeamFtScore": "2", "awayTeamHalftimeScore": "1", "awayTeamId": "cmr7becf90u96rx061s4bpzl5", "awayTeamName": "Uruguay", "awayTeamPenaltyScore": "4", "awayTeamScore": "3", "awayTeamSystem": "4-3-3", "countryId": "2", "countryLogo": "https://media.goal-api.com/badges/logo_country/2_intl.png", "countryName": "intl", "createdAt": "2026-07-13T18:04:51.473Z", "fkStageKey": "84", "homeTeam": { "badge": "https://media.goal-api.com/badges/512_canada.jpg", "id": "cmr7beceu0u8trx06vyjz9mnf", "name": "Canada" }, "homeTeamExtraScore": "0", "homeTeamFtScore": "2", "homeTeamHalftimeScore": "1", "homeTeamId": "cmr7beceu0u8trx06vyjz9mnf", "homeTeamName": "Canada", "homeTeamPenaltyScore": "3", "homeTeamScore": "2", "homeTeamSystem": "4-2-3-1", "id": "cmrjj8bl9ewu9o807g3qwd00e", "league": { "id": "cmr77dvhg0018rx06z11d3k9z", "logo": "https://media.goal-api.com/badges/logo_leagues/17_conmebol-copa-america.png", "name": "CONMEBOL Copa America", "popularity": 100 }, "leagueId": "cmr77dvhg0018rx06z11d3k9z", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/17_conmebol-copa-america.png", "leagueName": "CONMEBOL Copa America - 3rd Place Final", "leagueYear": "2024", "matchDate": "2024-07-14", "matchLive": "0", "matchReferee": "A. Herrera", "matchRound": null, "matchStadium": "Bank of America Stadium (Charlotte, North Carolina)", "matchStatus": "AFTER_PEN", "matchTime": "02:00", "stageName": "3rd Place Final", "teamAwayBadge": "https://media.goal-api.com/badges/539_uruguay.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/512_canada.jpg", "updatedAt": "2026-08-05T09:08:24.524Z", "videosCheckedAt": null } ], "leagueId": "cmr77dvhg0018rx06z11d3k9z", "pagination": { "hasMore": true, "limit": 5, "offset": 0, "total": 32 }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getLeaguesByIdFixtures" } }, "/leagues/{id}/top-scorers": { "get": { "tags": [ "Leagues" ], "summary": "Top scorers", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "League id" }, { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Scorers", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/TopScorer" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 5, "data": [ { "assists": "0", "createdAt": "2026-08-06T12:02:10.507Z", "goals": "4", "id": "cmshgucp7r281qd07ryllir77", "leagueId": "cmr77dvhg0018rx06z11d3k9z", "penaltyGoals": "0", "playerId": null, "playerKey": "2464726737", "playerName": "Lautaro Martínez", "playerPlace": "1", "season": null, "teamKey": "536", "teamName": "Argentina", "updatedAt": "2026-08-06T12:02:10.507Z" }, { "assists": "1", "createdAt": "2026-08-06T12:02:10.507Z", "goals": "2", "id": "cmshgucp7r282qd075n97uwgp", "leagueId": "cmr77dvhg0018rx06z11d3k9z", "penaltyGoals": "0", "playerId": null, "playerKey": "1235551573", "playerName": "M. Araújo", "playerPlace": "2", "season": null, "teamKey": "539", "teamName": "Uruguay", "updatedAt": "2026-08-06T12:02:10.507Z" } ], "leagueId": "cmr77dvhg0018rx06z11d3k9z", "metadata": { "lastUpdated": "2026-08-06T12:02:10.507Z", "topGoals": 4, "totalGoals": 12, "totalScorers": 5 }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getLeaguesByIdTopScorers" } }, "/leagues/{id}/results": { "get": { "tags": [ "Leagues" ], "summary": "Completed matches in a competition", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "League id" }, { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Results", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Fixture" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": [ { "apiId": "407738", "awayTeam": { "badge": "https://media.goal-api.com/badges/535_colombia.jpg", "id": "cmr7becf00u8xrx06mm08zlqn", "name": "Colombia" }, "awayTeamExtraScore": "0", "awayTeamFtScore": "0", "awayTeamHalftimeScore": "0", "awayTeamId": "cmr7becf00u8xrx06mm08zlqn", "awayTeamName": "Colombia", "awayTeamPenaltyScore": null, "awayTeamScore": "0", "awayTeamSystem": "4-3-3", "countryId": "2", "countryLogo": "https://media.goal-api.com/badges/logo_country/2_intl.png", "countryName": "intl", "createdAt": "2026-07-13T18:04:55.300Z", "fkStageKey": "83", "homeTeam": { "badge": "https://media.goal-api.com/badges/536_argentina.jpg", "id": "cmr7becf20u8zrx06zt8asrlw", "name": "Argentina" }, "homeTeamExtraScore": "1", "homeTeamFtScore": "0", "homeTeamHalftimeScore": "0", "homeTeamId": "cmr7becf20u8zrx06zt8asrlw", "homeTeamName": "Argentina", "homeTeamPenaltyScore": null, "homeTeamScore": "1", "homeTeamSystem": "4-4-2", "id": "cmrjj8ek8f5bvo807iofofwrf", "league": { "id": "cmr77dvhg0018rx06z11d3k9z", "logo": "https://media.goal-api.com/badges/logo_leagues/17_conmebol-copa-america.png", "name": "CONMEBOL Copa America", "popularity": 100 }, "leagueId": "cmr77dvhg0018rx06z11d3k9z", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/17_conmebol-copa-america.png", "leagueName": "CONMEBOL Copa America - Final", "leagueYear": "2024", "matchDate": "2024-07-15", "matchLive": "0", "matchReferee": "Raphael Claus", "matchRound": "Final", "matchStadium": "Hard Rock Stadium (Miami Gardens, Florida)", "matchStatus": "AFTER_ET", "matchTime": "02:30", "stageName": "Final", "teamAwayBadge": "https://media.goal-api.com/badges/535_colombia.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/536_argentina.jpg", "updatedAt": "2026-08-05T09:08:41.835Z", "videosCheckedAt": null }, { "apiId": "407737", "awayTeam": { "badge": "https://media.goal-api.com/badges/539_uruguay.jpg", "id": "cmr7becf90u96rx061s4bpzl5", "name": "Uruguay" }, "awayTeamExtraScore": "0", "awayTeamFtScore": "2", "awayTeamHalftimeScore": "1", "awayTeamId": "cmr7becf90u96rx061s4bpzl5", "awayTeamName": "Uruguay", "awayTeamPenaltyScore": "4", "awayTeamScore": "3", "awayTeamSystem": "4-3-3", "countryId": "2", "countryLogo": "https://media.goal-api.com/badges/logo_country/2_intl.png", "countryName": "intl", "createdAt": "2026-07-13T18:04:51.473Z", "fkStageKey": "84", "homeTeam": { "badge": "https://media.goal-api.com/badges/512_canada.jpg", "id": "cmr7beceu0u8trx06vyjz9mnf", "name": "Canada" }, "homeTeamExtraScore": "0", "homeTeamFtScore": "2", "homeTeamHalftimeScore": "1", "homeTeamId": "cmr7beceu0u8trx06vyjz9mnf", "homeTeamName": "Canada", "homeTeamPenaltyScore": "3", "homeTeamScore": "2", "homeTeamSystem": "4-2-3-1", "id": "cmrjj8bl9ewu9o807g3qwd00e", "league": { "id": "cmr77dvhg0018rx06z11d3k9z", "logo": "https://media.goal-api.com/badges/logo_leagues/17_conmebol-copa-america.png", "name": "CONMEBOL Copa America", "popularity": 100 }, "leagueId": "cmr77dvhg0018rx06z11d3k9z", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/17_conmebol-copa-america.png", "leagueName": "CONMEBOL Copa America - 3rd Place Final", "leagueYear": "2024", "matchDate": "2024-07-14", "matchLive": "0", "matchReferee": "A. Herrera", "matchRound": null, "matchStadium": "Bank of America Stadium (Charlotte, North Carolina)", "matchStatus": "AFTER_PEN", "matchTime": "02:00", "stageName": "3rd Place Final", "teamAwayBadge": "https://media.goal-api.com/badges/539_uruguay.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/512_canada.jpg", "updatedAt": "2026-08-05T09:08:24.524Z", "videosCheckedAt": null } ], "leagueId": "cmr77dvhg0018rx06z11d3k9z", "pagination": { "hasMore": true, "limit": 5, "offset": 0, "total": 32 }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getLeaguesByIdResults" } }, "/teams": { "get": { "tags": [ "Teams" ], "summary": "List teams", "parameters": [ { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" }, { "$ref": "#/components/parameters/search" }, { "$ref": "#/components/parameters/isActive" }, { "name": "country", "in": "query", "schema": { "type": "string" }, "description": "Filter by country name" } ], "responses": { "200": { "description": "Teams", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Team" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": [ { "_count": { "awayFixtures": 24, "homeFixtures": 22, "players": 0 }, "apiId": "13176", "badge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "country": "Belgium", "createdAt": "2026-07-12T18:31:36.644Z", "founded": null, "id": "cmri4qwgddrcqlb07pghzlize", "isActive": true, "name": "'s Gravenwezel-Schilde", "rosterSyncedAt": "2026-08-05T04:22:31.740Z", "updatedAt": "2026-08-05T04:22:31.759Z", "venueAddress": null, "venueCapacity": null, "venueCity": null, "venueName": null, "venueSurface": null }, { "_count": { "awayFixtures": 1, "homeFixtures": 1, "players": 0 }, "apiId": "40756", "badge": null, "country": "Netherlands", "createdAt": "2026-07-05T11:52:39.270Z", "founded": null, "id": "cmr7qeum1744jrx060d7ta9tm", "isActive": true, "name": "'t Zand", "rosterSyncedAt": "2026-08-05T04:14:51.877Z", "updatedAt": "2026-08-05T04:14:51.878Z", "venueAddress": null, "venueCapacity": null, "venueCity": null, "venueName": null, "venueSurface": null } ], "pagination": { "hasMore": true, "limit": 5, "offset": 0, "total": 15598 }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getTeams" } }, "/teams/{id}": { "get": { "tags": [ "Teams" ], "summary": "Get a team", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Team id" } ], "responses": { "200": { "description": "Team", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "$ref": "#/components/schemas/Team" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": { "_count": { "awayFixtures": 24, "homeFixtures": 22, "players": 0 }, "apiId": "13176", "badge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "coaches": [], "country": "Belgium", "createdAt": "2026-07-12T18:31:36.644Z", "founded": null, "id": "cmri4qwgddrcqlb07pghzlize", "isActive": true, "leagues": [ { "createdAt": "2026-07-12T18:31:37.938Z", "id": "cmri4qwtudrpzlb07s67s9oal", "league": { "id": "cmr77dw9g00gxrx06t139jbj2", "logo": "https://media.goal-api.com/badges/logo_leagues/64_cup.png", "name": "Cup", "season": "2025/2026" }, "leagueId": "cmr77dw9g00gxrx06t139jbj2", "season": "2025/2026", "teamId": "cmri4qwgddrcqlb07pghzlize", "updatedAt": "2026-08-05T04:22:27.523Z" } ], "name": "'s Gravenwezel-Schilde", "players": [], "rosterSyncedAt": "2026-08-05T04:22:31.740Z", "updatedAt": "2026-08-05T04:22:31.759Z", "venueAddress": null, "venueCapacity": null, "venueCity": null, "venueName": null, "venueSurface": null }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getTeamsById" } }, "/teams/{id}/players": { "get": { "tags": [ "Teams" ], "summary": "Squad", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Team id" }, { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Players", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Player" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": [], "groupedByType": { "defenders": [], "forwards": [], "goalkeepers": [], "midfielders": [] }, "pagination": { "hasMore": false, "limit": 5, "offset": 0, "total": 0 }, "source": "database", "success": true, "teamId": "cmri4qwgddrcqlb07pghzlize" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getTeamsByIdPlayers" } }, "/teams/{id}/fixtures": { "get": { "tags": [ "Teams" ], "summary": "Team fixtures", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Team id" }, { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Fixtures", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Fixture" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "awayFixtures": [ { "apiId": "633662", "awayTeam": { "badge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "id": "cmri4qwgddrcqlb07pghzlize", "name": "'s Gravenwezel-Schilde" }, "awayTeamExtraScore": null, "awayTeamFtScore": "1", "awayTeamHalftimeScore": null, "awayTeamId": "cmri4qwgddrcqlb07pghzlize", "awayTeamName": "'s Gravenwezel", "awayTeamPenaltyScore": null, "awayTeamScore": "1", "awayTeamSystem": null, "countryId": "23", "countryLogo": "https://media.goal-api.com/badges/logo_country/23_belgium.png", "countryName": "Belgium", "createdAt": "2026-07-13T17:26:45.879Z", "fkStageKey": "611", "homeTeam": { "badge": "https://media.goal-api.com/badges/9586_fc-du-geer.jpg", "id": "cmri4qwf1drbqlb07zvzl6a28", "name": "FC Du Geer" }, "homeTeamExtraScore": null, "homeTeamFtScore": "2", "homeTeamHalftimeScore": null, "homeTeamId": "cmri4qwf1drbqlb07zvzl6a28", "homeTeamName": "FC Du Geer", "homeTeamPenaltyScore": null, "homeTeamScore": "2", "homeTeamSystem": null, "id": "cmrjhvc31zenko807g7rexq2x", "league": { "id": "cmr77dw9g00gxrx06t139jbj2", "logo": "https://media.goal-api.com/badges/logo_leagues/64_cup.png", "name": "Cup", "popularity": 20 }, "leagueId": "cmr77dw9g00gxrx06t139jbj2", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/64_cup.png", "leagueName": "Cup - 2nd Round", "leagueYear": "2025/2026", "matchDate": "2025-08-03", "matchLive": "0", "matchReferee": null, "matchRound": null, "matchStadium": "Terrain du ESFC Geer (Geer)", "matchStatus": "FINISHED", "matchTime": "16:00", "stageName": "2nd Round", "teamAwayBadge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/9586_fc-du-geer.jpg", "updatedAt": "2026-08-05T06:53:10.511Z", "videosCheckedAt": "2026-07-16T03:26:35.673Z" }, { "apiId": "239102", "awayTeam": { "badge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "id": "cmri4qwgddrcqlb07pghzlize", "name": "'s Gravenwezel-Schilde" }, "awayTeamExtraScore": null, "awayTeamFtScore": "4", "awayTeamHalftimeScore": null, "awayTeamId": "cmri4qwgddrcqlb07pghzlize", "awayTeamName": "'s Gravenwezel-Schilde", "awayTeamPenaltyScore": null, "awayTeamScore": "4", "awayTeamSystem": null, "countryId": "23", "countryLogo": "https://media.goal-api.com/badges/logo_country/23_belgium.png", "countryName": "Belgium", "createdAt": "2026-07-13T18:11:23.791Z", "fkStageKey": "632", "homeTeam": { "badge": "https://media.goal-api.com/badges/9651_antonia.jpg", "id": "cmri6u85wdx4tlb07t8zxxq8h", "name": "Antonia" }, "homeTeamExtraScore": null, "homeTeamFtScore": "2", "homeTeamHalftimeScore": null, "homeTeamId": "cmri6u85wdx4tlb07t8zxxq8h", "homeTeamName": "Antonia", "homeTeamPenaltyScore": null, "homeTeamScore": "2", "homeTeamSystem": null, "id": "cmrjjgqahzy4ro807q764spo1", "league": { "id": "cmr77dw9g00gzrx0668xxd671", "logo": null, "name": "Provincial", "popularity": 5 }, "leagueId": "cmr77dw9g00gzrx0668xxd671", "leagueLogo": null, "leagueName": "Provincial - Antwerpen", "leagueYear": "2023/2024", "matchDate": "2024-04-28", "matchLive": "0", "matchReferee": null, "matchRound": "30", "matchStadium": "Sportcomplex Antonia FC (Zoersel)", "matchStatus": "FINISHED", "matchTime": "15:00", "stageName": "Antwerpen", "teamAwayBadge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/9651_antonia.jpg", "updatedAt": "2026-08-05T09:35:10.437Z", "videosCheckedAt": "2026-07-16T02:47:59.085Z" } ], "data": [ { "apiId": "633662", "awayTeam": { "badge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "id": "cmri4qwgddrcqlb07pghzlize", "name": "'s Gravenwezel-Schilde" }, "awayTeamExtraScore": null, "awayTeamFtScore": "1", "awayTeamHalftimeScore": null, "awayTeamId": "cmri4qwgddrcqlb07pghzlize", "awayTeamName": "'s Gravenwezel", "awayTeamPenaltyScore": null, "awayTeamScore": "1", "awayTeamSystem": null, "countryId": "23", "countryLogo": "https://media.goal-api.com/badges/logo_country/23_belgium.png", "countryName": "Belgium", "createdAt": "2026-07-13T17:26:45.879Z", "fkStageKey": "611", "homeTeam": { "badge": "https://media.goal-api.com/badges/9586_fc-du-geer.jpg", "id": "cmri4qwf1drbqlb07zvzl6a28", "name": "FC Du Geer" }, "homeTeamExtraScore": null, "homeTeamFtScore": "2", "homeTeamHalftimeScore": null, "homeTeamId": "cmri4qwf1drbqlb07zvzl6a28", "homeTeamName": "FC Du Geer", "homeTeamPenaltyScore": null, "homeTeamScore": "2", "homeTeamSystem": null, "id": "cmrjhvc31zenko807g7rexq2x", "league": { "id": "cmr77dw9g00gxrx06t139jbj2", "logo": "https://media.goal-api.com/badges/logo_leagues/64_cup.png", "name": "Cup", "popularity": 20 }, "leagueId": "cmr77dw9g00gxrx06t139jbj2", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/64_cup.png", "leagueName": "Cup - 2nd Round", "leagueYear": "2025/2026", "matchDate": "2025-08-03", "matchLive": "0", "matchReferee": null, "matchRound": null, "matchStadium": "Terrain du ESFC Geer (Geer)", "matchStatus": "FINISHED", "matchTime": "16:00", "stageName": "2nd Round", "teamAwayBadge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/9586_fc-du-geer.jpg", "updatedAt": "2026-08-05T06:53:10.511Z", "videosCheckedAt": "2026-07-16T03:26:35.673Z" }, { "apiId": "239102", "awayTeam": { "badge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "id": "cmri4qwgddrcqlb07pghzlize", "name": "'s Gravenwezel-Schilde" }, "awayTeamExtraScore": null, "awayTeamFtScore": "4", "awayTeamHalftimeScore": null, "awayTeamId": "cmri4qwgddrcqlb07pghzlize", "awayTeamName": "'s Gravenwezel-Schilde", "awayTeamPenaltyScore": null, "awayTeamScore": "4", "awayTeamSystem": null, "countryId": "23", "countryLogo": "https://media.goal-api.com/badges/logo_country/23_belgium.png", "countryName": "Belgium", "createdAt": "2026-07-13T18:11:23.791Z", "fkStageKey": "632", "homeTeam": { "badge": "https://media.goal-api.com/badges/9651_antonia.jpg", "id": "cmri6u85wdx4tlb07t8zxxq8h", "name": "Antonia" }, "homeTeamExtraScore": null, "homeTeamFtScore": "2", "homeTeamHalftimeScore": null, "homeTeamId": "cmri6u85wdx4tlb07t8zxxq8h", "homeTeamName": "Antonia", "homeTeamPenaltyScore": null, "homeTeamScore": "2", "homeTeamSystem": null, "id": "cmrjjgqahzy4ro807q764spo1", "league": { "id": "cmr77dw9g00gzrx0668xxd671", "logo": null, "name": "Provincial", "popularity": 5 }, "leagueId": "cmr77dw9g00gzrx0668xxd671", "leagueLogo": null, "leagueName": "Provincial - Antwerpen", "leagueYear": "2023/2024", "matchDate": "2024-04-28", "matchLive": "0", "matchReferee": null, "matchRound": "30", "matchStadium": "Sportcomplex Antonia FC (Zoersel)", "matchStatus": "FINISHED", "matchTime": "15:00", "stageName": "Antwerpen", "teamAwayBadge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/9651_antonia.jpg", "updatedAt": "2026-08-05T09:35:10.437Z", "videosCheckedAt": "2026-07-16T02:47:59.085Z" } ], "homeFixtures": [ { "apiId": "239092", "awayTeam": { "badge": "https://media.goal-api.com/badges/9650_bevel.jpg", "id": "cmri4qwgcdrcplb07dwmo2weq", "name": "Bevel" }, "awayTeamExtraScore": null, "awayTeamFtScore": "4", "awayTeamHalftimeScore": null, "awayTeamId": "cmri4qwgcdrcplb07dwmo2weq", "awayTeamName": "Bevel", "awayTeamPenaltyScore": null, "awayTeamScore": "4", "awayTeamSystem": null, "countryId": "23", "countryLogo": "https://media.goal-api.com/badges/logo_country/23_belgium.png", "countryName": "Belgium", "createdAt": "2026-07-13T18:13:07.275Z", "fkStageKey": "632", "homeTeam": { "badge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "id": "cmri4qwgddrcqlb07pghzlize", "name": "'s Gravenwezel-Schilde" }, "homeTeamExtraScore": null, "homeTeamFtScore": "1", "homeTeamHalftimeScore": null, "homeTeamId": "cmri4qwgddrcqlb07pghzlize", "homeTeamName": "'s Gravenwezel-Schilde", "homeTeamPenaltyScore": null, "homeTeamScore": "1", "homeTeamSystem": null, "id": "cmrjjiy6g67yjo807qdqglu8t", "league": { "id": "cmr77dw9g00gzrx0668xxd671", "logo": null, "name": "Provincial", "popularity": 5 }, "leagueId": "cmr77dw9g00gzrx0668xxd671", "leagueLogo": null, "leagueName": "Provincial - Antwerpen", "leagueYear": "2023/2024", "matchDate": "2024-04-21", "matchLive": "0", "matchReferee": null, "matchRound": "29", "matchStadium": "Terrein Schilde SK (Schilde)", "matchStatus": "FINISHED", "matchTime": "15:00", "stageName": "Antwerpen", "teamAwayBadge": "https://media.goal-api.com/badges/9650_bevel.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "updatedAt": "2026-08-05T09:40:44.877Z", "videosCheckedAt": "2026-07-16T02:47:16.723Z" }, { "apiId": "239079", "awayTeam": { "badge": "https://media.goal-api.com/badges/1574_berlaar-heikant.jpg", "id": "cmri4qwcwdraglb07u3lrr9qi", "name": "Berlaar-Heikant" }, "awayTeamExtraScore": null, "awayTeamFtScore": "5", "awayTeamHalftimeScore": null, "awayTeamId": "cmri4qwcwdraglb07u3lrr9qi", "awayTeamName": "Berlaar-Heikant", "awayTeamPenaltyScore": null, "awayTeamScore": "5", "awayTeamSystem": null, "countryId": "23", "countryLogo": "https://media.goal-api.com/badges/logo_country/23_belgium.png", "countryName": "Belgium", "createdAt": "2026-07-13T18:14:01.581Z", "fkStageKey": "632", "homeTeam": { "badge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "id": "cmri4qwgddrcqlb07pghzlize", "name": "'s Gravenwezel-Schilde" }, "homeTeamExtraScore": null, "homeTeamFtScore": "0", "homeTeamHalftimeScore": null, "homeTeamId": "cmri4qwgddrcqlb07pghzlize", "homeTeamName": "'s Gravenwezel-Schilde", "homeTeamPenaltyScore": null, "homeTeamScore": "0", "homeTeamSystem": null, "id": "cmrjjk43a9cy8o8075nea0g68", "league": { "id": "cmr77dw9g00gzrx0668xxd671", "logo": null, "name": "Provincial", "popularity": 5 }, "leagueId": "cmr77dw9g00gzrx0668xxd671", "leagueLogo": null, "leagueName": "Provincial - Antwerpen", "leagueYear": "2023/2024", "matchDate": "2024-04-07", "matchLive": "0", "matchReferee": null, "matchRound": "27", "matchStadium": "Terrein Schilde SK (Schilde)", "matchStatus": "FINISHED", "matchTime": "15:00", "stageName": "Antwerpen", "teamAwayBadge": "https://media.goal-api.com/badges/1574_berlaar-heikant.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "updatedAt": "2026-08-05T09:44:14.038Z", "videosCheckedAt": "2026-07-16T02:45:52.197Z" } ], "pagination": { "hasMore": true, "limit": 5, "offset": 0, "total": 46 }, "source": "database", "success": true, "teamId": "cmri4qwgddrcqlb07pghzlize" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getTeamsByIdFixtures" } }, "/teams/{id}/results": { "get": { "tags": [ "Teams" ], "summary": "Recent results", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Team id" }, { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Results", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Fixture" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": [ { "apiId": "633662", "awayTeam": { "badge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "id": "cmri4qwgddrcqlb07pghzlize", "name": "'s Gravenwezel-Schilde" }, "awayTeamExtraScore": null, "awayTeamFtScore": "1", "awayTeamHalftimeScore": null, "awayTeamId": "cmri4qwgddrcqlb07pghzlize", "awayTeamName": "'s Gravenwezel", "awayTeamPenaltyScore": null, "awayTeamScore": "1", "awayTeamSystem": null, "countryId": "23", "countryLogo": "https://media.goal-api.com/badges/logo_country/23_belgium.png", "countryName": "Belgium", "createdAt": "2026-07-13T17:26:45.879Z", "fkStageKey": "611", "homeTeam": { "badge": "https://media.goal-api.com/badges/9586_fc-du-geer.jpg", "id": "cmri4qwf1drbqlb07zvzl6a28", "name": "FC Du Geer" }, "homeTeamExtraScore": null, "homeTeamFtScore": "2", "homeTeamHalftimeScore": null, "homeTeamId": "cmri4qwf1drbqlb07zvzl6a28", "homeTeamName": "FC Du Geer", "homeTeamPenaltyScore": null, "homeTeamScore": "2", "homeTeamSystem": null, "id": "cmrjhvc31zenko807g7rexq2x", "league": { "id": "cmr77dw9g00gxrx06t139jbj2", "logo": "https://media.goal-api.com/badges/logo_leagues/64_cup.png", "name": "Cup", "popularity": 20 }, "leagueId": "cmr77dw9g00gxrx06t139jbj2", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/64_cup.png", "leagueName": "Cup - 2nd Round", "leagueYear": "2025/2026", "matchDate": "2025-08-03", "matchLive": "0", "matchReferee": null, "matchRound": null, "matchStadium": "Terrain du ESFC Geer (Geer)", "matchStatus": "FINISHED", "matchTime": "16:00", "stageName": "2nd Round", "teamAwayBadge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/9586_fc-du-geer.jpg", "updatedAt": "2026-08-05T06:53:10.511Z", "videosCheckedAt": "2026-07-16T03:26:35.673Z" }, { "apiId": "239102", "awayTeam": { "badge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "id": "cmri4qwgddrcqlb07pghzlize", "name": "'s Gravenwezel-Schilde" }, "awayTeamExtraScore": null, "awayTeamFtScore": "4", "awayTeamHalftimeScore": null, "awayTeamId": "cmri4qwgddrcqlb07pghzlize", "awayTeamName": "'s Gravenwezel-Schilde", "awayTeamPenaltyScore": null, "awayTeamScore": "4", "awayTeamSystem": null, "countryId": "23", "countryLogo": "https://media.goal-api.com/badges/logo_country/23_belgium.png", "countryName": "Belgium", "createdAt": "2026-07-13T18:11:23.791Z", "fkStageKey": "632", "homeTeam": { "badge": "https://media.goal-api.com/badges/9651_antonia.jpg", "id": "cmri6u85wdx4tlb07t8zxxq8h", "name": "Antonia" }, "homeTeamExtraScore": null, "homeTeamFtScore": "2", "homeTeamHalftimeScore": null, "homeTeamId": "cmri6u85wdx4tlb07t8zxxq8h", "homeTeamName": "Antonia", "homeTeamPenaltyScore": null, "homeTeamScore": "2", "homeTeamSystem": null, "id": "cmrjjgqahzy4ro807q764spo1", "league": { "id": "cmr77dw9g00gzrx0668xxd671", "logo": null, "name": "Provincial", "popularity": 5 }, "leagueId": "cmr77dw9g00gzrx0668xxd671", "leagueLogo": null, "leagueName": "Provincial - Antwerpen", "leagueYear": "2023/2024", "matchDate": "2024-04-28", "matchLive": "0", "matchReferee": null, "matchRound": "30", "matchStadium": "Sportcomplex Antonia FC (Zoersel)", "matchStatus": "FINISHED", "matchTime": "15:00", "stageName": "Antwerpen", "teamAwayBadge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/9651_antonia.jpg", "updatedAt": "2026-08-05T09:35:10.437Z", "videosCheckedAt": "2026-07-16T02:47:59.085Z" } ], "pagination": { "hasMore": true, "limit": 5, "offset": 0, "total": 46 }, "source": "database", "stats": { "avgGoalsConceded": 3, "avgGoalsScored": 1.2, "drawPercentage": 0, "draws": 0, "goalDifference": -9, "goalsAgainst": 15, "goalsFor": 6, "lossPercentage": 80, "losses": 4, "played": 5, "points": 3, "pointsPerGame": 0.6, "winPercentage": 20, "wins": 1 }, "success": true, "teamId": "cmri4qwgddrcqlb07pghzlize" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getTeamsByIdResults" } }, "/teams/{id}/upcoming": { "get": { "tags": [ "Teams" ], "summary": "Upcoming fixtures", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Team id" }, { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Fixtures", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Fixture" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 0, "data": [], "source": "database", "success": true, "teamId": "cmri4qwgddrcqlb07pghzlize" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getTeamsByIdUpcoming" } }, "/teams/{id}/statistics": { "get": { "tags": [ "Teams" ], "summary": "Team statistics", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Team id" } ], "responses": { "200": { "description": "Statistics", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "$ref": "#/components/schemas/TeamStatistics" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": { "away": { "avgGoalsConceded": 1.79, "avgGoalsScored": 1.33, "drawPercentage": 16.67, "draws": 4, "goalDifference": -11, "goalsAgainst": 43, "goalsFor": 32, "lossPercentage": 45.83, "losses": 11, "played": 24, "points": 31, "pointsPerGame": 1.29, "winPercentage": 37.5, "wins": 9 }, "form": "LWLLL", "home": { "avgGoalsConceded": 2.23, "avgGoalsScored": 1, "drawPercentage": 22.73, "draws": 5, "goalDifference": -27, "goalsAgainst": 49, "goalsFor": 22, "lossPercentage": 63.64, "losses": 14, "played": 22, "points": 14, "pointsPerGame": 0.64, "winPercentage": 13.64, "wins": 3 }, "overall": { "avgGoalsConceded": 2, "avgGoalsScored": 1.17, "drawPercentage": 19.57, "draws": 9, "goalDifference": -38, "goalsAgainst": 92, "goalsFor": 54, "lossPercentage": 54.35, "losses": 25, "played": 46, "points": 45, "pointsPerGame": 0.98, "winPercentage": 26.09, "wins": 12 }, "recentFixtures": [ { "date": "2025-08-03", "id": "cmrjhvc31zenko807g7rexq2x", "isHome": false, "league": "Cup", "opponent": "FC Du Geer", "opponentBadge": "https://apiv3.apifootball.com/badges/9586_fc-du-geer.jpg", "result": "L", "score": "2-1" }, { "date": "2024-04-28", "id": "cmrjjgqahzy4ro807q764spo1", "isHome": false, "league": "Provincial", "opponent": "Antonia", "opponentBadge": "https://apiv3.apifootball.com/badges/9651_antonia.jpg", "result": "W", "score": "2-4" } ], "season": "All time", "totalMatches": 46 }, "source": "database", "success": true, "teamId": "cmri4qwgddrcqlb07pghzlize" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getTeamsByIdStatistics" } }, "/fixtures": { "get": { "tags": [ "Fixtures" ], "summary": "List fixtures", "parameters": [ { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" }, { "name": "from", "in": "query", "schema": { "type": "string", "format": "date" }, "description": "Start of date range, YYYY-MM-DD" }, { "name": "to", "in": "query", "schema": { "type": "string", "format": "date" }, "description": "End of date range, YYYY-MM-DD" }, { "name": "leagueId", "in": "query", "schema": { "type": "string" } }, { "name": "teamId", "in": "query", "schema": { "type": "string" } }, { "name": "status", "in": "query", "schema": { "$ref": "#/components/schemas/MatchStatus" } } ], "responses": { "200": { "description": "Fixtures", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Fixture" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": [ { "apiId": "829952", "awayTeam": { "badge": "https://media.goal-api.com/badges/32341_real-cundinamarca.jpg", "id": "cmr7uq19i951urx06343j4kfy", "name": "Real Cundinamarca" }, "awayTeamExtraScore": null, "awayTeamFtScore": null, "awayTeamHalftimeScore": null, "awayTeamId": "cmr7uq19i951urx06343j4kfy", "awayTeamName": "Real Cundinamarca", "awayTeamPenaltyScore": null, "awayTeamScore": null, "awayTeamSystem": null, "countryId": "34", "countryLogo": "https://media.goal-api.com/badges/logo_country/34_colombia.png", "countryName": "Colombia", "createdAt": "2026-08-04T00:02:24.132Z", "fkStageKey": "18865", "homeTeam": { "badge": "https://media.goal-api.com/badges/2270_la-equidad.jpg", "id": "cmr7upxw193ssrx060r8seosf", "name": "La Equidad" }, "homeTeamExtraScore": null, "homeTeamFtScore": null, "homeTeamHalftimeScore": null, "homeTeamId": "cmr7upxw193ssrx060r8seosf", "homeTeamName": "Inter Bogotá", "homeTeamPenaltyScore": null, "homeTeamScore": null, "homeTeamSystem": null, "id": "cmsdw90rexmwukw065zwl8glz", "league": { "id": "cmr77dvv600aqrx068v1tyhd0", "logo": "https://media.goal-api.com/badges/logo_leagues/475_copa-colombia.png", "name": "Copa Colombia", "popularity": 20 }, "leagueId": "cmr77dvv600aqrx068v1tyhd0", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/475_copa-colombia.png", "leagueName": "Copa Colombia - 1/8-finals", "leagueYear": "2026", "matchDate": "2026-08-13", "matchLive": "0", "matchReferee": null, "matchRound": null, "matchStadium": "Estadio Metropolitano de Techo", "matchStatus": "SCHEDULED", "matchTime": "23:00", "stageName": "1/8-finals", "teamAwayBadge": "https://media.goal-api.com/badges/32341_real-cundinamarca.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/2270_la-equidad.jpg", "updatedAt": "2026-08-06T12:01:29.660Z", "videosCheckedAt": null }, { "apiId": "834743", "awayTeam": { "badge": "https://media.goal-api.com/badges/24470_independiente-res..jpg", "id": "cmr7skqe887i6rx06w9bv9hzg", "name": "Independiente Res." }, "awayTeamExtraScore": null, "awayTeamFtScore": null, "awayTeamHalftimeScore": null, "awayTeamId": "cmr7skqe887i6rx06w9bv9hzg", "awayTeamName": "Independiente 2", "awayTeamPenaltyScore": null, "awayTeamScore": null, "awayTeamSystem": null, "countryId": "14", "countryLogo": "https://media.goal-api.com/badges/logo_country/14_argentina.png", "countryName": "Argentina", "createdAt": "2026-08-06T06:01:35.983Z", "fkStageKey": "19045", "homeTeam": { "badge": "https://media.goal-api.com/badges/24569_central-cordoba-sde-res..jpg", "id": "cmr7skqdo87hwrx0628g62z8b", "name": "Central Córdoba SdE Res." }, "homeTeamExtraScore": null, "homeTeamFtScore": null, "homeTeamHalftimeScore": null, "homeTeamId": "cmr7skqdo87hwrx0628g62z8b", "homeTeamName": "Central Cordoba 2", "homeTeamPenaltyScore": null, "homeTeamScore": null, "homeTeamSystem": null, "id": "cmsh3yns7jqhhqd07r39e49c2", "league": { "id": "cmr77dvtd009hrx06bys03xaz", "logo": "https://media.goal-api.com/badges/logo_leagues/7096_torneo-proyeccion.png", "name": "Torneo Proyección", "popularity": 20 }, "leagueId": "cmr77dvtd009hrx06bys03xaz", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/7096_torneo-proyeccion.png", "leagueName": "Torneo Proyección - Clausura", "leagueYear": "2026", "matchDate": "2026-08-13", "matchLive": "0", "matchReferee": null, "matchRound": "4", "matchStadium": null, "matchStatus": "SCHEDULED", "matchTime": "22:00", "stageName": "Clausura", "teamAwayBadge": "https://media.goal-api.com/badges/24470_independiente-res..jpg", "teamHomeBadge": "https://media.goal-api.com/badges/24569_central-cordoba-sde-res..jpg", "updatedAt": "2026-08-06T12:01:29.660Z", "videosCheckedAt": null } ], "pagination": { "hasMore": true, "limit": 5, "offset": 0, "total": 686496 }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getFixtures" } }, "/fixtures/live": { "get": { "tags": [ "Fixtures" ], "summary": "Matches in play right now", "parameters": [ { "name": "leagueId", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Live matches", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Fixture" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 3, "data": [ { "apiId": "776330", "awayTeam": { "badge": "https://media.goal-api.com/badges/9391_aalesunds-u19.jpg", "id": "cmr7qehx46zl6rx06vv0f3j8w", "name": "Aalesunds U19" }, "awayTeamExtraScore": null, "awayTeamFtScore": null, "awayTeamHalftimeScore": "0", "awayTeamId": "cmr7qehx46zl6rx06vv0f3j8w", "awayTeamName": "Aalesund U19", "awayTeamPenaltyScore": null, "awayTeamScore": "0", "awayTeamSystem": null, "countryId": "87", "countryLogo": "https://media.goal-api.com/badges/logo_country/87_norway.png", "countryName": "Norway", "createdAt": "2026-07-29T00:01:40.844Z", "events": [], "fkStageKey": "35638", "homeTeam": { "badge": "https://media.goal-api.com/badges/9403_lillestrm-u19.jpg", "id": "cmr7qehy06zlrrx0615v8euix", "name": "Lillestrøm U19" }, "homeTeamExtraScore": null, "homeTeamFtScore": null, "homeTeamHalftimeScore": "0", "homeTeamId": "cmr7qehy06zlrrx0615v8euix", "homeTeamName": "Lillestrom U19", "homeTeamPenaltyScore": null, "homeTeamScore": "0", "homeTeamSystem": null, "id": "cms5bkz95wdmckw06fywaigdh", "league": { "id": "cmr77dvr4007qrx066g0imfsp", "logo": "https://media.goal-api.com/badges/logo_leagues/471_nasjonal-u19-champions-league.png", "name": "Nasjonal U19 Champions League" }, "leagueId": "cmr77dvr4007qrx066g0imfsp", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/471_nasjonal-u19-champions-league.png", "leagueName": "Nasjonal U19 Champions League - 1/8-finals", "leagueYear": "2026", "matchDate": "2026-08-06", "matchLive": "1", "matchReferee": null, "matchRound": null, "matchStadium": null, "matchStatus": "LIVE", "matchTime": "14:30", "stageName": "1/8-finals", "teamAwayBadge": "https://media.goal-api.com/badges/9391_aalesunds-u19.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/9403_lillestrm-u19.jpg", "updatedAt": "2026-08-06T12:36:46.519Z", "videosCheckedAt": null }, { "apiId": "753775", "awayTeam": { "badge": "https://media.goal-api.com/badges/5123_kairat-ii.jpg", "id": "cmrikysekf8d1s107f64u3uqo", "name": "Kairat II" }, "awayTeamExtraScore": null, "awayTeamFtScore": null, "awayTeamHalftimeScore": "0", "awayTeamId": "cmrikysekf8d1s107f64u3uqo", "awayTeamName": "Kairat Almaty 2", "awayTeamPenaltyScore": null, "awayTeamScore": "0", "awayTeamSystem": null, "countryId": "66", "countryLogo": "https://media.goal-api.com/badges/logo_country/66_kazakhstan.png", "countryName": "Kazakhstan", "createdAt": "2026-07-30T00:01:13.536Z", "events": [], "fkStageKey": "1198", "homeTeam": { "badge": null, "id": "cmrikysegf8cxs107a4bgj3e4", "name": "Yelimay Semey 2" }, "homeTeamExtraScore": null, "homeTeamFtScore": null, "homeTeamHalftimeScore": "0", "homeTeamId": "cmrikysegf8cxs107a4bgj3e4", "homeTeamName": "Yelimay Semey 2", "homeTeamPenaltyScore": null, "homeTeamScore": "0", "homeTeamSystem": null, "id": "cms6r08t4m87qkw06ng6hcfyd", "league": { "id": "cmr77dwjp00kurx06h60kwo7e", "logo": "https://media.goal-api.com/badges/logo_leagues/215_1-division.png", "name": "1. Division" }, "leagueId": "cmr77dwjp00kurx06h60kwo7e", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/215_1-division.png", "leagueName": "1. Division", "leagueYear": "2026", "matchDate": "2026-08-06", "matchLive": "1", "matchReferee": null, "matchRound": "17", "matchStadium": null, "matchStatus": "LIVE", "matchTime": "14:00", "stageName": "Current", "teamAwayBadge": "https://media.goal-api.com/badges/5123_kairat-ii.jpg", "teamHomeBadge": null, "updatedAt": "2026-08-06T12:36:26.495Z", "videosCheckedAt": null } ], "source": "database", "success": true, "timestamp": "2026-08-06T12:37:19.186Z" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getFixturesLive" } }, "/fixtures/date/{date}": { "get": { "tags": [ "Fixtures" ], "summary": "Fixtures on a date", "parameters": [ { "name": "date", "in": "path", "required": true, "schema": { "type": "string", "format": "date" }, "description": "YYYY-MM-DD" }, { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Fixtures", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Fixture" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": [ { "apiId": "746486", "awayTeam": { "badge": "https://media.goal-api.com/badges/2756_9-de-octubre.jpg", "id": "cmri8zcq5eetglb07bs8q9zbh", "name": "9 de Octubre" }, "awayTeamExtraScore": null, "awayTeamFtScore": null, "awayTeamHalftimeScore": null, "awayTeamId": "cmri8zcq5eetglb07bs8q9zbh", "awayTeamName": "Nueve de Octubre", "awayTeamPenaltyScore": null, "awayTeamScore": null, "awayTeamSystem": null, "countryId": "41", "countryLogo": "https://media.goal-api.com/badges/logo_country/41_ecuador.png", "countryName": "Ecuador", "createdAt": "2026-07-31T00:01:33.545Z", "fkStageKey": "898", "homeTeam": { "badge": "https://media.goal-api.com/badges/2744_el-nacional.jpg", "id": "cmri8zcpzeetclb07hvl83iib", "name": "El Nacional" }, "homeTeamExtraScore": null, "homeTeamFtScore": null, "homeTeamHalftimeScore": null, "homeTeamId": "cmri8zcpzeetclb07hvl83iib", "homeTeamName": "EL Nacional", "homeTeamPenaltyScore": null, "homeTeamScore": null, "homeTeamSystem": null, "id": "cms86giv0nvzfkw06vcte64ho", "league": { "id": "cmr77dwb300hxrx066d3mzb5m", "logo": "https://media.goal-api.com/badges/logo_leagues/139_liga-pro-serie-b.png", "name": "Liga Pro Serie B", "popularity": 5 }, "leagueId": "cmr77dwb300hxrx066d3mzb5m", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/139_liga-pro-serie-b.png", "leagueName": "Liga Pro Serie B", "leagueYear": "2026", "matchDate": "2026-08-06", "matchLive": "0", "matchReferee": null, "matchRound": "20", "matchStadium": null, "matchStatus": "SCHEDULED", "matchTime": "23:30", "stageName": "Current", "teamAwayBadge": "https://media.goal-api.com/badges/2756_9-de-octubre.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/2744_el-nacional.jpg", "updatedAt": "2026-08-06T12:00:37.746Z", "videosCheckedAt": null }, { "apiId": "781694", "awayTeam": { "badge": "https://media.goal-api.com/badges/9976_leones-fc.jpg", "id": "cmr7uq19e951srx067iced2cn", "name": "Leones FC" }, "awayTeamExtraScore": null, "awayTeamFtScore": null, "awayTeamHalftimeScore": null, "awayTeamId": "cmr7uq19e951srx067iced2cn", "awayTeamName": "Leones", "awayTeamPenaltyScore": null, "awayTeamScore": null, "awayTeamSystem": null, "countryId": "34", "countryLogo": "https://media.goal-api.com/badges/logo_country/34_colombia.png", "countryName": "Colombia", "createdAt": "2026-07-31T00:01:33.556Z", "fkStageKey": "4602", "homeTeam": { "badge": "https://media.goal-api.com/badges/9443_bogota.jpg", "id": "cmr7uq19m951wrx06gf0e03ej", "name": "Bogotá" }, "homeTeamExtraScore": null, "homeTeamFtScore": null, "homeTeamHalftimeScore": null, "homeTeamId": "cmr7uq19m951wrx06gf0e03ej", "homeTeamName": "Bogota", "homeTeamPenaltyScore": null, "homeTeamScore": null, "homeTeamSystem": null, "id": "cms86gj6vnw19kw06btz4j6z8", "league": { "id": "cmr77dvv600asrx06y051mw74", "logo": "https://media.goal-api.com/badges/logo_leagues/517_primera-b.png", "name": "Primera B", "popularity": 20 }, "leagueId": "cmr77dvv600asrx06y051mw74", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/517_primera-b.png", "leagueName": "Primera B - Clausura", "leagueYear": "2026", "matchDate": "2026-08-06", "matchLive": "0", "matchReferee": null, "matchRound": "3", "matchStadium": "Estadio Metropolitano de Techo", "matchStatus": "SCHEDULED", "matchTime": "23:30", "stageName": "Clausura", "teamAwayBadge": "https://media.goal-api.com/badges/9976_leones-fc.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/9443_bogota.jpg", "updatedAt": "2026-08-06T12:00:37.746Z", "videosCheckedAt": null } ], "date": "2026-08-06", "pagination": { "hasMore": true, "limit": 5, "offset": 0, "total": 159 }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getFixturesDateByDate" } }, "/fixtures/{id}": { "get": { "tags": [ "Fixtures" ], "summary": "Get a fixture", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Fixture id. Accepts either our id or the provider match id." } ], "responses": { "200": { "description": "Fixture", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "$ref": "#/components/schemas/Fixture" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": { "apiId": "829288", "awayTeam": { "badge": null, "country": null, "id": "cmr7uozss8rksrx063zmy1g2l", "name": "Izberbash" }, "awayTeamExtraScore": null, "awayTeamFtScore": null, "awayTeamHalftimeScore": null, "awayTeamId": "cmr7uozss8rksrx063zmy1g2l", "awayTeamName": "Izberbash", "awayTeamPenaltyScore": null, "awayTeamScore": "3", "awayTeamSystem": null, "cards": [], "countryId": "95", "countryLogo": "https://media.goal-api.com/badges/logo_country/95_russia.png", "countryName": "Russia", "createdAt": "2026-08-05T00:01:36.849Z", "events": [], "fkStageKey": "18748", "homeTeam": { "badge": "https://media.goal-api.com/badges/6276_chayka.jpg", "country": "Russia", "id": "cmr7uopa08np1rx06rjek9er9", "name": "Chayka" }, "homeTeamExtraScore": null, "homeTeamFtScore": null, "homeTeamHalftimeScore": null, "homeTeamId": "cmr7uopa08np1rx06rjek9er9", "homeTeamName": "FK Chayka", "homeTeamPenaltyScore": null, "homeTeamScore": "0", "homeTeamSystem": null, "id": "cmsfbnv0b7t2vuj072522zpo9", "league": { "country": { "id": "cmr77dvu600a3rx06qy28ysij", "logo": "https://media.goal-api.com/badges/logo_country/95_russia.png", "name": "Russia" }, "id": "cmr77dvua00a5rx068jzuqnfv", "logo": "https://media.goal-api.com/badges/logo_leagues/275_cup.png", "name": "Cup" }, "leagueId": "cmr77dvua00a5rx068jzuqnfv", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/275_cup.png", "leagueName": "Cup - 1/16-finals", "leagueYear": "2026/2027", "lineups": [ { "createdAt": "2026-08-06T12:01:24.507Z", "fixtureId": "cmsfbnv0b7t2vuj072522zpo9", "id": "cmshgtdbcqx34qd07h2l4dxqm", "lineupNumber": null, "lineupPlayer": "Dmitri Kombarov", "lineupPosition": "", "playerId": null, "playerKey": "2612839801", "team": "home", "type": "coach", "updatedAt": "2026-08-06T12:01:24.507Z" } ], "matchDate": "2026-08-12", "matchLive": "0", "matchReferee": null, "matchRound": null, "matchStadium": null, "matchStatus": "AWARDED", "matchTime": "17:00", "stageName": "1/16-finals", "statistics": [], "substitutions": [], "teamAwayBadge": null, "teamHomeBadge": "https://media.goal-api.com/badges/6276_chayka.jpg", "updatedAt": "2026-08-06T12:01:23.832Z", "videos": [], "videosCheckedAt": null }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getFixturesById" } }, "/fixtures/{id}/events": { "get": { "tags": [ "Fixtures" ], "summary": "Match timeline", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Fixture id" } ], "responses": { "200": { "description": "Events", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/MatchEvent" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 0, "data": [], "fixtureId": "cmsfbnv0b7t2vuj072522zpo9", "grouped": { "cards": [], "goals": [], "other": [], "substitutions": [] }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getFixturesByIdEvents" } }, "/fixtures/{id}/lineups": { "get": { "tags": [ "Fixtures" ], "summary": "Lineups, formations and bench", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Fixture id" } ], "responses": { "200": { "description": "Lineups", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "$ref": "#/components/schemas/Lineups" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": { "away": { "coach": [], "missingPlayers": [], "startingLineups": [], "substitutes": [] }, "awayFormation": null, "hasLineups": true, "home": { "coach": [ { "createdAt": "2026-08-06T12:01:24.507Z", "fixtureId": "cmsfbnv0b7t2vuj072522zpo9", "id": "cmshgtdbcqx34qd07h2l4dxqm", "lineupNumber": null, "lineupPlayer": "Dmitri Kombarov", "lineupPosition": "", "player": null, "playerId": null, "playerKey": "2612839801", "team": "home", "type": "coach", "updatedAt": "2026-08-06T12:01:24.507Z" } ], "missingPlayers": [], "startingLineups": [], "substitutes": [] }, "homeFormation": null }, "fixtureId": "cmsfbnv0b7t2vuj072522zpo9", "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getFixturesByIdLineups" } }, "/fixtures/{id}/statistics": { "get": { "tags": [ "Fixtures" ], "summary": "Match statistics", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Fixture id" } ], "responses": { "200": { "description": "Statistics", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "$ref": "#/components/schemas/MatchStatistics" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": { "hasStatistics": false, "match": { "firstHalf": [], "fullTime": [], "secondHalf": [] }, "players": { "away": [], "home": [] } }, "fixtureId": "cmsfbnv0b7t2vuj072522zpo9", "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getFixturesByIdStatistics" } }, "/fixtures/{id}/cards": { "get": { "tags": [ "Fixtures" ], "summary": "Cards shown", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Fixture id" } ], "responses": { "200": { "description": "Cards", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/MatchEvent" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 0, "data": [], "fixtureId": "cmsfbnv0b7t2vuj072522zpo9", "grouped": { "away": [], "home": [], "red": [], "yellow": [] }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getFixturesByIdCards" } }, "/fixtures/{id}/substitutions": { "get": { "tags": [ "Fixtures" ], "summary": "Substitutions", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Fixture id" } ], "responses": { "200": { "description": "Substitutions", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/MatchEvent" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 0, "data": [], "fixtureId": "cmsfbnv0b7t2vuj072522zpo9", "grouped": { "away": [], "home": [] }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getFixturesByIdSubstitutions" } }, "/fixtures/{id}/odds": { "get": { "tags": [ "Odds" ], "summary": "Pre-match odds for a fixture", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Fixture id" } ], "responses": { "200": { "description": "Odds by bookmaker", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Odd" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 0, "data": [], "fixtureId": "cmsfbnv0b7t2vuj072522zpo9", "matchApiId": "829288", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getFixturesByIdOdds" } }, "/fixtures/{id}/live-odds": { "get": { "tags": [ "Odds" ], "summary": "In-play odds for a fixture", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Fixture id" } ], "responses": { "200": { "description": "Live odds", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/LiveOdd" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 0, "data": [], "fixtureId": "cmsfbnv0b7t2vuj072522zpo9", "matchApiId": "829288", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getFixturesByIdLiveOdds" } }, "/fixtures/{id}/predictions": { "get": { "tags": [ "Predictions" ], "summary": "Prediction for a fixture", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Fixture id" } ], "responses": { "200": { "description": "Prediction", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "$ref": "#/components/schemas/Prediction" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": null, "fixtureId": "cmsfbnv0b7t2vuj072522zpo9", "matchApiId": "829288", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getFixturesByIdPredictions" } }, "/fixtures/{id}/commentary": { "get": { "tags": [ "Fixtures" ], "summary": "Minute-by-minute commentary", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Fixture id" } ], "responses": { "200": { "description": "Commentary", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Commentary" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 0, "data": [], "fixtureId": "cmsfbnv0b7t2vuj072522zpo9", "matchApiId": "829288", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getFixturesByIdCommentary" } }, "/results": { "get": { "tags": [ "Results" ], "summary": "Completed matches", "parameters": [ { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Results", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Fixture" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": [ { "apiId": "829288", "awayTeam": { "badge": null, "id": "cmr7uozss8rksrx063zmy1g2l", "name": "Izberbash" }, "awayTeamExtraScore": null, "awayTeamFtScore": null, "awayTeamHalftimeScore": null, "awayTeamId": "cmr7uozss8rksrx063zmy1g2l", "awayTeamName": "Izberbash", "awayTeamPenaltyScore": null, "awayTeamScore": "3", "awayTeamSystem": null, "countryId": "95", "countryLogo": "https://media.goal-api.com/badges/logo_country/95_russia.png", "countryName": "Russia", "createdAt": "2026-08-05T00:01:36.849Z", "fkStageKey": "18748", "homeTeam": { "badge": "https://media.goal-api.com/badges/6276_chayka.jpg", "id": "cmr7uopa08np1rx06rjek9er9", "name": "Chayka" }, "homeTeamExtraScore": null, "homeTeamFtScore": null, "homeTeamHalftimeScore": null, "homeTeamId": "cmr7uopa08np1rx06rjek9er9", "homeTeamName": "FK Chayka", "homeTeamPenaltyScore": null, "homeTeamScore": "0", "homeTeamSystem": null, "id": "cmsfbnv0b7t2vuj072522zpo9", "league": { "id": "cmr77dvua00a5rx068jzuqnfv", "logo": "https://media.goal-api.com/badges/logo_leagues/275_cup.png", "name": "Cup", "popularity": 20 }, "leagueId": "cmr77dvua00a5rx068jzuqnfv", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/275_cup.png", "leagueName": "Cup - 1/16-finals", "leagueYear": "2026/2027", "matchDate": "2026-08-12", "matchLive": "0", "matchReferee": null, "matchRound": null, "matchStadium": null, "matchStatus": "AWARDED", "matchTime": "17:00", "stageName": "1/16-finals", "teamAwayBadge": null, "teamHomeBadge": "https://media.goal-api.com/badges/6276_chayka.jpg", "updatedAt": "2026-08-06T12:01:23.832Z", "videosCheckedAt": null } ], "pagination": { "hasMore": true, "limit": 1, "offset": 0, "total": 655766 }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getResults" } }, "/results/stats": { "get": { "tags": [ "Results" ], "summary": "Aggregate statistics over completed matches", "parameters": [ { "name": "leagueId", "in": "query", "schema": { "type": "string" }, "description": "Restrict to one competition" }, { "name": "from", "in": "query", "schema": { "type": "string", "format": "date" }, "description": "Start of date range, YYYY-MM-DD" }, { "name": "to", "in": "query", "schema": { "type": "string", "format": "date" }, "description": "End of date range, YYYY-MM-DD" } ], "responses": { "200": { "description": "Statistics", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "$ref": "#/components/schemas/ResultsStats" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": { "averageAwayGoals": 1.24, "averageGoals": 2.85, "averageHomeGoals": 1.61, "awayWinPercentage": 32, "awayWins": 318, "bttsCount": 484, "bttsPercentage": 48, "cleanSheets": { "away": 269, "home": 362 }, "drawPercentage": 23, "draws": 234, "highestScoringMatch": { "awayTeam": "Tanabi U20", "date": "2026-08-02", "homeTeam": "RB Bragantino U20", "id": "cms119qjbwmdekw06bnb1zzow", "score": "16-1" }, "homeWinPercentage": 45, "homeWins": 448, "mostCommonScore": { "count": 115, "percentage": 12, "score": "0-0" }, "mostGoalsInMatch": 17, "over25Count": 545, "over25Percentage": 55, "over35Count": 329, "over35Percentage": 33, "scoreDistribution": { "0-0": 115, "0-1": 74, "0-15": 1, "0-2": 36, "0-3": 23, "0-4": 11, "0-5": 4, "0-6": 3, "0-7": 2, "1-0": 95, "1-1": 73, "1-2": 73, "1-3": 29, "1-4": 18, "1-5": 4, "1-6": 1, "1-7": 1, "1-9": 2, "16-1": 1, "2-0": 62, "2-1": 78, "2-2": 35, "2-3": 22, "2-4": 4, "2-5": 2, "2-6": 2, "2-7": 1, "3-0": 42, "3-1": 38, "3-2": 21, "3-3": 11, "3-4": 3, "3-5": 1, "4-0": 21, "4-1": 22, "4-2": 14, "4-3": 3, "4-5": 1, "5-0": 14, "5-1": 14, "5-2": 2, "5-3": 2, "6-0": 6, "6-1": 2, "6-4": 1, "7-0": 3, "7-2": 2, "8-0": 2, "8-1": 1, "9-0": 2 }, "totalGoals": 2851, "totalMatches": 1000 }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getResultsStats" } }, "/results/today": { "get": { "tags": [ "Results" ], "summary": "Today's completed matches", "parameters": [ { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Results", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Fixture" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 45, "data": [ { "apiId": "748282", "awayTeam": { "badge": "https://media.goal-api.com/badges/11587_south-adelaide-panthers.jpg", "id": "cmr7bdzxs0psnrx06svawq8ur", "name": "South Adelaide Panthers" }, "awayTeamExtraScore": null, "awayTeamFtScore": "3", "awayTeamHalftimeScore": "2", "awayTeamId": "cmr7bdzxs0psnrx06svawq8ur", "awayTeamName": "South Adelaide", "awayTeamPenaltyScore": null, "awayTeamScore": "3", "awayTeamSystem": null, "countryId": "17", "countryLogo": "https://media.goal-api.com/badges/logo_country/17_australia.png", "countryName": "Australia", "createdAt": "2026-08-01T00:01:27.410Z", "fkStageKey": "4935", "homeTeam": { "badge": "https://media.goal-api.com/badges/34107_salisbury-united.jpg", "id": "cmr7bdzxe0psjrx065kv26ych", "name": "Salisbury United" }, "homeTeamExtraScore": null, "homeTeamFtScore": "2", "homeTeamHalftimeScore": "1", "homeTeamId": "cmr7bdzxe0psjrx065kv26ych", "homeTeamName": "Salisbury Utd.", "homeTeamPenaltyScore": null, "homeTeamScore": "2", "homeTeamSystem": null, "id": "cms9lw8wafy2kkw06d13m4qzl", "league": { "id": "cmr77dvgy000urx06f1o0fim8", "logo": "https://media.goal-api.com/badges/logo_leagues/680_south-australia-state-league-1.png", "name": "South Australia State League 1", "popularity": 5 }, "leagueId": "cmr77dvgy000urx06f1o0fim8", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/680_south-australia-state-league-1.png", "leagueName": "South Australia State League 1", "leagueYear": "2026", "matchDate": "2026-08-06", "matchLive": "1", "matchReferee": null, "matchRound": "21", "matchStadium": null, "matchStatus": "FINISHED", "matchTime": "12:00", "stageName": "Current", "teamAwayBadge": "https://media.goal-api.com/badges/11587_south-adelaide-panthers.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/34107_salisbury-united.jpg", "updatedAt": "2026-08-06T12:14:00.217Z", "videosCheckedAt": "2026-08-06T12:00:01.072Z" }, { "apiId": "834720", "awayTeam": { "badge": "https://media.goal-api.com/badges/31872_patha-chakra.jpg", "id": "cmr7qg0hn7fm6rx06yaxn0dv3", "name": "Patha Chakra" }, "awayTeamExtraScore": null, "awayTeamFtScore": "1", "awayTeamHalftimeScore": "0", "awayTeamId": "cmr7qg0hn7fm6rx06yaxn0dv3", "awayTeamName": "Patha Chakra", "awayTeamPenaltyScore": null, "awayTeamScore": "1", "awayTeamSystem": null, "countryId": "58", "countryLogo": "https://media.goal-api.com/badges/logo_country/58_india.png", "countryName": "India", "createdAt": "2026-08-06T06:00:39.731Z", "fkStageKey": "35654", "homeTeam": { "badge": "https://media.goal-api.com/badges/31843_kalighat-milan-sangha.jpg", "id": "cmr7qg0hk7fm4rx06d3zdms6c", "name": "Kalighat Milan Sangha" }, "homeTeamExtraScore": null, "homeTeamFtScore": "6", "homeTeamHalftimeScore": "2", "homeTeamId": "cmr7qg0hk7fm4rx06d3zdms6c", "homeTeamName": "Kalighat", "homeTeamPenaltyScore": null, "homeTeamScore": "6", "homeTeamSystem": null, "id": "cmsh3xg3gji64qd07xl5sul4b", "league": { "id": "cmr77dvry008frx06jzu492t2", "logo": "https://media.goal-api.com/badges/logo_leagues/8009_calcutta-premier-division.png", "name": "Calcutta Premier Division", "popularity": 20 }, "leagueId": "cmr77dvry008frx06jzu492t2", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/8009_calcutta-premier-division.png", "leagueName": "Calcutta Premier Division - Group Stage", "leagueYear": "2026/2027", "matchDate": "2026-08-06", "matchLive": "0", "matchReferee": null, "matchRound": null, "matchStadium": null, "matchStatus": "FINISHED", "matchTime": "11:30", "stageName": "Group Stage", "teamAwayBadge": "https://media.goal-api.com/badges/31872_patha-chakra.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/31843_kalighat-milan-sangha.jpg", "updatedAt": "2026-08-06T12:00:36.001Z", "videosCheckedAt": "2026-08-06T12:00:01.059Z" } ], "date": "2026-08-06", "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getResultsToday" } }, "/results/yesterday": { "get": { "tags": [ "Results" ], "summary": "Yesterday's completed matches", "parameters": [ { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Results", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Fixture" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 205, "data": [ { "apiId": "834997", "awayTeam": { "badge": "https://media.goal-api.com/badges/35228_panama-u21.jpg", "id": "cmsb9zvigk7uhkw06muqpyr6o", "name": "Panama U21" }, "awayTeamExtraScore": null, "awayTeamFtScore": "0", "awayTeamHalftimeScore": "0", "awayTeamId": "cmsb9zvigk7uhkw06muqpyr6o", "awayTeamName": "Panama U21", "awayTeamPenaltyScore": null, "awayTeamScore": "0", "awayTeamSystem": null, "countryId": "2", "countryLogo": "https://media.goal-api.com/badges/logo_country/2_intl.png", "countryName": "intl", "createdAt": "2026-08-06T12:00:33.717Z", "fkStageKey": "9090", "homeTeam": { "badge": "https://media.goal-api.com/badges/9025_mexico-u20.jpg", "id": "cmri2l6wdcl0llb07g4ox4fym", "name": "Mexico U20" }, "homeTeamExtraScore": null, "homeTeamFtScore": "4", "homeTeamHalftimeScore": "3", "homeTeamId": "cmri2l6wdcl0llb07g4ox4fym", "homeTeamName": "Mexico U21", "homeTeamPenaltyScore": null, "homeTeamScore": "4", "homeTeamSystem": null, "id": "cmshgsa4dqnvtqd07il1fthra", "league": { "id": "cmr77dvhg002arx06nxkwdwfy", "logo": null, "name": "CAC Games", "popularity": 20 }, "leagueId": "cmr77dvhg002arx06nxkwdwfy", "leagueLogo": null, "leagueName": "CAC Games - Semi-finals", "leagueYear": "2026", "matchDate": "2026-08-05", "matchLive": "0", "matchReferee": null, "matchRound": "Semi-finals", "matchStadium": "Estadio Complejo Deportivo Moca 85", "matchStatus": "FINISHED", "matchTime": "22:00", "stageName": "Semi-finals", "teamAwayBadge": "https://media.goal-api.com/badges/35228_panama-u21.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/9025_mexico-u20.jpg", "updatedAt": "2026-08-06T12:00:33.717Z", "videosCheckedAt": null }, { "apiId": "821460", "awayTeam": { "badge": "https://media.goal-api.com/badges/11596_zambia-w.jpg", "id": "cmr7dk2zi1tberx06ibx6bajp", "name": "Zambia W" }, "awayTeamExtraScore": null, "awayTeamFtScore": "2", "awayTeamHalftimeScore": "2", "awayTeamId": "cmr7dk2zi1tberx06ibx6bajp", "awayTeamName": "Zambia W", "awayTeamPenaltyScore": null, "awayTeamScore": "2", "awayTeamSystem": null, "countryId": "2", "countryLogo": "https://media.goal-api.com/badges/logo_country/2_intl.png", "countryName": "intl", "createdAt": "2026-07-29T00:01:42.431Z", "fkStageKey": "35846", "homeTeam": { "badge": "https://media.goal-api.com/badges/33420_malawi-w.jpg", "id": "cmr7fp4d02o42rx06mubozds9", "name": "Malawi W" }, "homeTeamExtraScore": null, "homeTeamFtScore": "1", "homeTeamHalftimeScore": "0", "homeTeamId": "cmr7fp4d02o42rx06mubozds9", "homeTeamName": "Malawi W", "homeTeamPenaltyScore": null, "homeTeamScore": "1", "homeTeamSystem": null, "id": "cms5bl0dgwdvjkw06ruflsp6a", "league": { "id": "cmr77dvhg002frx069bc95atm", "logo": null, "name": "CAF Women's Africa Cup of Nations", "popularity": 50 }, "leagueId": "cmr77dvhg002frx069bc95atm", "leagueLogo": null, "leagueName": "CAF Women's Africa Cup of Nations - Africa Cup Of Nations Women", "leagueYear": "2026", "matchDate": "2026-08-05", "matchLive": "0", "matchReferee": "V. E. Amedome", "matchRound": "3", "matchStadium": null, "matchStatus": "FINISHED", "matchTime": "22:00", "stageName": "Africa Cup Of Nations Women", "teamAwayBadge": "https://media.goal-api.com/badges/11596_zambia-w.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/33420_malawi-w.jpg", "updatedAt": "2026-08-06T12:00:33.642Z", "videosCheckedAt": "2026-08-06T08:00:00.712Z" } ], "date": "2026-08-05", "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getResultsYesterday" } }, "/results/high-scoring": { "get": { "tags": [ "Results" ], "summary": "High-scoring matches", "parameters": [ { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Results", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Fixture" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 5, "data": [ { "apiId": "770297", "awayScore": 15, "awayTeam": { "badge": "https://media.goal-api.com/badges/3934_augsburg.jpg", "id": "cmr79jabh03zirx06g3efkze7", "name": "Augsburg" }, "awayTeamExtraScore": null, "awayTeamFtScore": "15", "awayTeamHalftimeScore": "8", "awayTeamId": "cmr79jabh03zirx06g3efkze7", "awayTeamName": "Augsburg", "awayTeamPenaltyScore": null, "awayTeamScore": "15", "awayTeamSystem": null, "countryId": "133", "countryLogo": "https://media.goal-api.com/badges/logo_country/133_world.png", "countryName": "World", "createdAt": "2026-07-29T00:01:41.658Z", "fkStageKey": "24954", "homeScore": 0, "homeTeam": { "badge": "https://media.goal-api.com/badges/1262_schwaz.jpg", "id": "cmr7huoye3qpcrx06p8fb7qdc", "name": "Schwaz" }, "homeTeamExtraScore": null, "homeTeamFtScore": "0", "homeTeamHalftimeScore": "0", "homeTeamId": "cmr7huoye3qpcrx06p8fb7qdc", "homeTeamName": "Schwaz", "homeTeamPenaltyScore": null, "homeTeamScore": "0", "homeTeamSystem": null, "id": "cms5bkzvowdskkw06yz41948j", "league": { "id": "cmr77dwv800nxrx065czxdl0q", "logo": "https://media.goal-api.com/badges/logo_leagues/355_club-friendlies.png", "name": "Club Friendlies", "popularity": 20 }, "leagueId": "cmr77dwv800nxrx065czxdl0q", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/355_club-friendlies.png", "leagueName": "Club Friendlies - Group Stage", "leagueYear": "2026", "matchDate": "2026-08-05", "matchLive": "0", "matchReferee": null, "matchRound": null, "matchStadium": null, "matchStatus": "FINISHED", "matchTime": "19:00", "stageName": "Group Stage", "teamAwayBadge": "https://media.goal-api.com/badges/3934_augsburg.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/1262_schwaz.jpg", "totalGoals": 15, "updatedAt": "2026-08-06T12:00:29.815Z", "videosCheckedAt": "2026-08-05T20:00:04.139Z" }, { "apiId": "794474", "awayScore": 9, "awayTeam": { "badge": "https://media.goal-api.com/badges/2660_thisted.jpg", "id": "cmri0g7o9bmhqlb07k84jfehz", "name": "Thisted" }, "awayTeamExtraScore": null, "awayTeamFtScore": "9", "awayTeamHalftimeScore": "6", "awayTeamId": "cmri0g7o9bmhqlb07k84jfehz", "awayTeamName": "Thisted FC", "awayTeamPenaltyScore": null, "awayTeamScore": "9", "awayTeamSystem": null, "countryId": "40", "countryLogo": "https://media.goal-api.com/badges/logo_country/40_denmark.png", "countryName": "Denmark", "createdAt": "2026-07-28T00:02:23.549Z", "fkStageKey": "16858", "homeScore": 1, "homeTeam": { "badge": null, "id": "cms1b1u9ga534kw06a1ptc6yf", "name": "Aabybro" }, "homeTeamExtraScore": null, "homeTeamFtScore": "1", "homeTeamHalftimeScore": "1", "homeTeamId": "cms1b1u9ga534kw06a1ptc6yf", "homeTeamName": "Aabybro", "homeTeamPenaltyScore": null, "homeTeamScore": "1", "homeTeamSystem": null, "id": "cms3w61ogj3xhkw06ulm6o5u7", "league": { "id": "cmr77dw2000f1rx06s1t7xyh5", "logo": "https://media.goal-api.com/badges/logo_leagues/351_dbu-pokalen.png", "name": "DBU Pokalen", "popularity": 20 }, "leagueId": "cmr77dw2000f1rx06s1t7xyh5", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/351_dbu-pokalen.png", "leagueName": "DBU Pokalen - 1/64-finals", "leagueYear": "2026/2027", "matchDate": "2026-08-04", "matchLive": "0", "matchReferee": null, "matchRound": null, "matchStadium": null, "matchStatus": "FINISHED", "matchTime": "18:30", "stageName": "1/64-finals", "teamAwayBadge": "https://media.goal-api.com/badges/2660_thisted.jpg", "teamHomeBadge": null, "totalGoals": 10, "updatedAt": "2026-08-06T12:00:18.420Z", "videosCheckedAt": "2026-08-04T20:00:02.718Z" } ], "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getResultsHighScoring" } }, "/results/date/{date}": { "get": { "tags": [ "Results" ], "summary": "Results on a date", "parameters": [ { "name": "date", "in": "path", "required": true, "schema": { "type": "string", "format": "date" } }, { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Results", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Fixture" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 45, "data": [ { "apiId": "748282", "awayTeam": { "badge": "https://media.goal-api.com/badges/11587_south-adelaide-panthers.jpg", "id": "cmr7bdzxs0psnrx06svawq8ur", "name": "South Adelaide Panthers" }, "awayTeamExtraScore": null, "awayTeamFtScore": "3", "awayTeamHalftimeScore": "2", "awayTeamId": "cmr7bdzxs0psnrx06svawq8ur", "awayTeamName": "South Adelaide", "awayTeamPenaltyScore": null, "awayTeamScore": "3", "awayTeamSystem": null, "countryId": "17", "countryLogo": "https://media.goal-api.com/badges/logo_country/17_australia.png", "countryName": "Australia", "createdAt": "2026-08-01T00:01:27.410Z", "fkStageKey": "4935", "homeTeam": { "badge": "https://media.goal-api.com/badges/34107_salisbury-united.jpg", "id": "cmr7bdzxe0psjrx065kv26ych", "name": "Salisbury United" }, "homeTeamExtraScore": null, "homeTeamFtScore": "2", "homeTeamHalftimeScore": "1", "homeTeamId": "cmr7bdzxe0psjrx065kv26ych", "homeTeamName": "Salisbury Utd.", "homeTeamPenaltyScore": null, "homeTeamScore": "2", "homeTeamSystem": null, "id": "cms9lw8wafy2kkw06d13m4qzl", "league": { "id": "cmr77dvgy000urx06f1o0fim8", "logo": "https://media.goal-api.com/badges/logo_leagues/680_south-australia-state-league-1.png", "name": "South Australia State League 1", "popularity": 5 }, "leagueId": "cmr77dvgy000urx06f1o0fim8", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/680_south-australia-state-league-1.png", "leagueName": "South Australia State League 1", "leagueYear": "2026", "matchDate": "2026-08-06", "matchLive": "1", "matchReferee": null, "matchRound": "21", "matchStadium": null, "matchStatus": "FINISHED", "matchTime": "12:00", "stageName": "Current", "teamAwayBadge": "https://media.goal-api.com/badges/11587_south-adelaide-panthers.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/34107_salisbury-united.jpg", "updatedAt": "2026-08-06T12:14:00.217Z", "videosCheckedAt": "2026-08-06T12:00:01.072Z" }, { "apiId": "834720", "awayTeam": { "badge": "https://media.goal-api.com/badges/31872_patha-chakra.jpg", "id": "cmr7qg0hn7fm6rx06yaxn0dv3", "name": "Patha Chakra" }, "awayTeamExtraScore": null, "awayTeamFtScore": "1", "awayTeamHalftimeScore": "0", "awayTeamId": "cmr7qg0hn7fm6rx06yaxn0dv3", "awayTeamName": "Patha Chakra", "awayTeamPenaltyScore": null, "awayTeamScore": "1", "awayTeamSystem": null, "countryId": "58", "countryLogo": "https://media.goal-api.com/badges/logo_country/58_india.png", "countryName": "India", "createdAt": "2026-08-06T06:00:39.731Z", "fkStageKey": "35654", "homeTeam": { "badge": "https://media.goal-api.com/badges/31843_kalighat-milan-sangha.jpg", "id": "cmr7qg0hk7fm4rx06d3zdms6c", "name": "Kalighat Milan Sangha" }, "homeTeamExtraScore": null, "homeTeamFtScore": "6", "homeTeamHalftimeScore": "2", "homeTeamId": "cmr7qg0hk7fm4rx06d3zdms6c", "homeTeamName": "Kalighat", "homeTeamPenaltyScore": null, "homeTeamScore": "6", "homeTeamSystem": null, "id": "cmsh3xg3gji64qd07xl5sul4b", "league": { "id": "cmr77dvry008frx06jzu492t2", "logo": "https://media.goal-api.com/badges/logo_leagues/8009_calcutta-premier-division.png", "name": "Calcutta Premier Division", "popularity": 20 }, "leagueId": "cmr77dvry008frx06jzu492t2", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/8009_calcutta-premier-division.png", "leagueName": "Calcutta Premier Division - Group Stage", "leagueYear": "2026/2027", "matchDate": "2026-08-06", "matchLive": "0", "matchReferee": null, "matchRound": null, "matchStadium": null, "matchStatus": "FINISHED", "matchTime": "11:30", "stageName": "Group Stage", "teamAwayBadge": "https://media.goal-api.com/badges/31872_patha-chakra.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/31843_kalighat-milan-sangha.jpg", "updatedAt": "2026-08-06T12:00:36.001Z", "videosCheckedAt": "2026-08-06T12:00:01.059Z" } ], "date": "2026-08-06", "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getResultsDateByDate" } }, "/results/league/{leagueId}": { "get": { "tags": [ "Results" ], "summary": "Results for a competition", "parameters": [ { "name": "leagueId", "in": "path", "required": true, "schema": { "type": "string" }, "description": "League id" }, { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Results", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Fixture" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": [ { "apiId": "407738", "awayTeam": { "badge": "https://media.goal-api.com/badges/535_colombia.jpg", "id": "cmr7becf00u8xrx06mm08zlqn", "name": "Colombia" }, "awayTeamExtraScore": "0", "awayTeamFtScore": "0", "awayTeamHalftimeScore": "0", "awayTeamId": "cmr7becf00u8xrx06mm08zlqn", "awayTeamName": "Colombia", "awayTeamPenaltyScore": null, "awayTeamScore": "0", "awayTeamSystem": "4-3-3", "countryId": "2", "countryLogo": "https://media.goal-api.com/badges/logo_country/2_intl.png", "countryName": "intl", "createdAt": "2026-07-13T18:04:55.300Z", "fkStageKey": "83", "homeTeam": { "badge": "https://media.goal-api.com/badges/536_argentina.jpg", "id": "cmr7becf20u8zrx06zt8asrlw", "name": "Argentina" }, "homeTeamExtraScore": "1", "homeTeamFtScore": "0", "homeTeamHalftimeScore": "0", "homeTeamId": "cmr7becf20u8zrx06zt8asrlw", "homeTeamName": "Argentina", "homeTeamPenaltyScore": null, "homeTeamScore": "1", "homeTeamSystem": "4-4-2", "id": "cmrjj8ek8f5bvo807iofofwrf", "league": { "id": "cmr77dvhg0018rx06z11d3k9z", "logo": "https://media.goal-api.com/badges/logo_leagues/17_conmebol-copa-america.png", "name": "CONMEBOL Copa America", "popularity": 100 }, "leagueId": "cmr77dvhg0018rx06z11d3k9z", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/17_conmebol-copa-america.png", "leagueName": "CONMEBOL Copa America - Final", "leagueYear": "2024", "matchDate": "2024-07-15", "matchLive": "0", "matchReferee": "Raphael Claus", "matchRound": "Final", "matchStadium": "Hard Rock Stadium (Miami Gardens, Florida)", "matchStatus": "AFTER_ET", "matchTime": "02:30", "stageName": "Final", "teamAwayBadge": "https://media.goal-api.com/badges/535_colombia.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/536_argentina.jpg", "updatedAt": "2026-08-05T09:08:41.835Z", "videosCheckedAt": null }, { "apiId": "407737", "awayTeam": { "badge": "https://media.goal-api.com/badges/539_uruguay.jpg", "id": "cmr7becf90u96rx061s4bpzl5", "name": "Uruguay" }, "awayTeamExtraScore": "0", "awayTeamFtScore": "2", "awayTeamHalftimeScore": "1", "awayTeamId": "cmr7becf90u96rx061s4bpzl5", "awayTeamName": "Uruguay", "awayTeamPenaltyScore": "4", "awayTeamScore": "3", "awayTeamSystem": "4-3-3", "countryId": "2", "countryLogo": "https://media.goal-api.com/badges/logo_country/2_intl.png", "countryName": "intl", "createdAt": "2026-07-13T18:04:51.473Z", "fkStageKey": "84", "homeTeam": { "badge": "https://media.goal-api.com/badges/512_canada.jpg", "id": "cmr7beceu0u8trx06vyjz9mnf", "name": "Canada" }, "homeTeamExtraScore": "0", "homeTeamFtScore": "2", "homeTeamHalftimeScore": "1", "homeTeamId": "cmr7beceu0u8trx06vyjz9mnf", "homeTeamName": "Canada", "homeTeamPenaltyScore": "3", "homeTeamScore": "2", "homeTeamSystem": "4-2-3-1", "id": "cmrjj8bl9ewu9o807g3qwd00e", "league": { "id": "cmr77dvhg0018rx06z11d3k9z", "logo": "https://media.goal-api.com/badges/logo_leagues/17_conmebol-copa-america.png", "name": "CONMEBOL Copa America", "popularity": 100 }, "leagueId": "cmr77dvhg0018rx06z11d3k9z", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/17_conmebol-copa-america.png", "leagueName": "CONMEBOL Copa America - 3rd Place Final", "leagueYear": "2024", "matchDate": "2024-07-14", "matchLive": "0", "matchReferee": "A. Herrera", "matchRound": null, "matchStadium": "Bank of America Stadium (Charlotte, North Carolina)", "matchStatus": "AFTER_PEN", "matchTime": "02:00", "stageName": "3rd Place Final", "teamAwayBadge": "https://media.goal-api.com/badges/539_uruguay.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/512_canada.jpg", "updatedAt": "2026-08-05T09:08:24.524Z", "videosCheckedAt": null } ], "leagueId": "cmr77dvhg0018rx06z11d3k9z", "pagination": { "hasMore": true, "limit": 5, "offset": 0, "total": 32 }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getResultsLeagueByLeagueId" } }, "/results/team/{teamId}": { "get": { "tags": [ "Results" ], "summary": "Results for a team", "parameters": [ { "name": "teamId", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Team id" }, { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Results", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Fixture" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": [ { "apiId": "633662", "awayTeam": { "badge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "id": "cmri4qwgddrcqlb07pghzlize", "name": "'s Gravenwezel-Schilde" }, "awayTeamExtraScore": null, "awayTeamFtScore": "1", "awayTeamHalftimeScore": null, "awayTeamId": "cmri4qwgddrcqlb07pghzlize", "awayTeamName": "'s Gravenwezel", "awayTeamPenaltyScore": null, "awayTeamScore": "1", "awayTeamSystem": null, "countryId": "23", "countryLogo": "https://media.goal-api.com/badges/logo_country/23_belgium.png", "countryName": "Belgium", "createdAt": "2026-07-13T17:26:45.879Z", "fkStageKey": "611", "homeTeam": { "badge": "https://media.goal-api.com/badges/9586_fc-du-geer.jpg", "id": "cmri4qwf1drbqlb07zvzl6a28", "name": "FC Du Geer" }, "homeTeamExtraScore": null, "homeTeamFtScore": "2", "homeTeamHalftimeScore": null, "homeTeamId": "cmri4qwf1drbqlb07zvzl6a28", "homeTeamName": "FC Du Geer", "homeTeamPenaltyScore": null, "homeTeamScore": "2", "homeTeamSystem": null, "id": "cmrjhvc31zenko807g7rexq2x", "league": { "id": "cmr77dw9g00gxrx06t139jbj2", "logo": "https://media.goal-api.com/badges/logo_leagues/64_cup.png", "name": "Cup", "popularity": 20 }, "leagueId": "cmr77dw9g00gxrx06t139jbj2", "leagueLogo": "https://media.goal-api.com/badges/logo_leagues/64_cup.png", "leagueName": "Cup - 2nd Round", "leagueYear": "2025/2026", "matchDate": "2025-08-03", "matchLive": "0", "matchReferee": null, "matchRound": null, "matchStadium": "Terrain du ESFC Geer (Geer)", "matchStatus": "FINISHED", "matchTime": "16:00", "stageName": "2nd Round", "teamAwayBadge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/9586_fc-du-geer.jpg", "updatedAt": "2026-08-05T06:53:10.511Z", "videosCheckedAt": "2026-07-16T03:26:35.673Z" }, { "apiId": "239102", "awayTeam": { "badge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "id": "cmri4qwgddrcqlb07pghzlize", "name": "'s Gravenwezel-Schilde" }, "awayTeamExtraScore": null, "awayTeamFtScore": "4", "awayTeamHalftimeScore": null, "awayTeamId": "cmri4qwgddrcqlb07pghzlize", "awayTeamName": "'s Gravenwezel-Schilde", "awayTeamPenaltyScore": null, "awayTeamScore": "4", "awayTeamSystem": null, "countryId": "23", "countryLogo": "https://media.goal-api.com/badges/logo_country/23_belgium.png", "countryName": "Belgium", "createdAt": "2026-07-13T18:11:23.791Z", "fkStageKey": "632", "homeTeam": { "badge": "https://media.goal-api.com/badges/9651_antonia.jpg", "id": "cmri6u85wdx4tlb07t8zxxq8h", "name": "Antonia" }, "homeTeamExtraScore": null, "homeTeamFtScore": "2", "homeTeamHalftimeScore": null, "homeTeamId": "cmri6u85wdx4tlb07t8zxxq8h", "homeTeamName": "Antonia", "homeTeamPenaltyScore": null, "homeTeamScore": "2", "homeTeamSystem": null, "id": "cmrjjgqahzy4ro807q764spo1", "league": { "id": "cmr77dw9g00gzrx0668xxd671", "logo": null, "name": "Provincial", "popularity": 5 }, "leagueId": "cmr77dw9g00gzrx0668xxd671", "leagueLogo": null, "leagueName": "Provincial - Antwerpen", "leagueYear": "2023/2024", "matchDate": "2024-04-28", "matchLive": "0", "matchReferee": null, "matchRound": "30", "matchStadium": "Sportcomplex Antonia FC (Zoersel)", "matchStatus": "FINISHED", "matchTime": "15:00", "stageName": "Antwerpen", "teamAwayBadge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "teamHomeBadge": "https://media.goal-api.com/badges/9651_antonia.jpg", "updatedAt": "2026-08-05T09:35:10.437Z", "videosCheckedAt": "2026-07-16T02:47:59.085Z" } ], "pagination": { "hasMore": true, "limit": 5, "offset": 0, "total": 46 }, "source": "database", "success": true, "teamId": "cmri4qwgddrcqlb07pghzlize" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getResultsTeamByTeamId" } }, "/players": { "get": { "tags": [ "Players" ], "summary": "List players", "parameters": [ { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" }, { "$ref": "#/components/parameters/search" }, { "name": "teamId", "in": "query", "schema": { "type": "string" } }, { "name": "type", "in": "query", "schema": { "$ref": "#/components/schemas/PlayerPosition" } } ], "responses": { "200": { "description": "Players", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Player" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": [ { "age": "29", "apiId": "1477558463", "assists": null, "birthdate": "1996-10-04", "blocks": null, "clearances": null, "country": null, "createdAt": "2026-07-12T18:30:33.255Z", "crossesTotal": null, "dispossessed": null, "dribbleAttempts": null, "dribbleSucc": null, "duelsTotal": null, "duelsWon": null, "foulsCommitted": null, "goals": null, "goalsConceded": null, "id": "cmri4pmx1d6lwlb073oxcrciz", "image": "https://media.goal-api.com/badges/players/70549_v-sadovskiy.jpg", "injured": "No", "insideBoxSaves": null, "interceptions": null, "isActive": true, "isCaptain": false, "keyPasses": null, "matchPlayed": null, "minutes": null, "name": "(Vsevolod) Sadovski Usevalad", "number": "90", "passes": null, "passesAccuracy": null, "penCommitted": null, "penMissed": null, "penScored": null, "penWon": null, "rating": null, "redCards": null, "saves": null, "shotsTotal": null, "substituteOut": null, "substitutesOnBench": null, "tackles": null, "team": { "badge": "https://media.goal-api.com/badges/11637_okzhetpes.jpg", "id": "cmrikysi4f8ebs107u36g7kqv", "name": "Okzhetpes" }, "teamId": "cmrikysi4f8ebs107u36g7kqv", "type": "Forwards", "updatedAt": "2026-08-05T04:01:22.088Z", "woodworks": null, "yellowCards": null }, { "age": null, "apiId": "215998281", "assists": "0", "birthdate": null, "blocks": null, "clearances": null, "country": null, "createdAt": "2026-07-12T19:30:58.924Z", "crossesTotal": null, "dispossessed": null, "dribbleAttempts": null, "dribbleSucc": null, "duelsTotal": null, "duelsWon": null, "foulsCommitted": null, "goals": "0", "goalsConceded": null, "id": "cmri6v9euea88lb07w0bz6epq", "image": null, "injured": "No", "insideBoxSaves": null, "interceptions": null, "isActive": true, "isCaptain": false, "keyPasses": null, "matchPlayed": "1", "minutes": null, "name": "?. Diubea", "number": null, "passes": null, "passesAccuracy": null, "penCommitted": null, "penMissed": null, "penScored": null, "penWon": null, "rating": null, "redCards": "0", "saves": null, "shotsTotal": null, "substituteOut": "0", "substitutesOnBench": "0", "tackles": null, "team": { "badge": null, "id": "cmri6v6lxe9m3lb07otixau8b", "name": "Vointa Livezile" }, "teamId": "cmri6v6lxe9m3lb07otixau8b", "type": "Defenders", "updatedAt": "2026-07-26T04:37:57.690Z", "woodworks": null, "yellowCards": "0" } ], "pagination": { "hasMore": true, "limit": 5, "offset": 0, "total": 184855 }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getPlayers" } }, "/players/search": { "get": { "tags": [ "Players" ], "summary": "Search players by name", "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Search term" }, { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Matches", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Player" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 566, "data": [ { "age": null, "apiId": "3155643217", "assists": null, "birthdate": null, "blocks": null, "clearances": null, "country": null, "createdAt": "2026-07-05T10:53:43.213Z", "crossesTotal": null, "dispossessed": null, "dribbleAttempts": null, "dribbleSucc": null, "duelsTotal": null, "duelsWon": null, "foulsCommitted": null, "goals": "0", "goalsConceded": null, "id": "cmr7ob53l6sdgrx069qwcffbf", "image": null, "injured": "No", "insideBoxSaves": null, "interceptions": null, "isActive": true, "isCaptain": false, "keyPasses": null, "matchPlayed": "0", "minutes": null, "name": "A. Creuse Da Silva", "number": null, "passes": null, "passesAccuracy": null, "penCommitted": null, "penMissed": null, "penScored": null, "penWon": null, "rating": null, "redCards": "0", "saves": null, "shotsTotal": null, "substituteOut": "0", "substitutesOnBench": "0", "tackles": null, "team": { "badge": "https://media.goal-api.com/badges/3783_moulins-yzeure-foot.jpg", "id": "cmr7ob0k36rbrrx06c0usc4cg", "name": "Moulins Yzeure Foot" }, "teamId": "cmr7ob0k36rbrrx06c0usc4cg", "type": "Defenders", "updatedAt": "2026-07-13T15:52:22.965Z", "woodworks": null, "yellowCards": "0" }, { "age": null, "apiId": "3721839570", "assists": null, "birthdate": "2004-11-29", "blocks": null, "clearances": null, "country": null, "createdAt": "2026-07-05T10:53:43.213Z", "crossesTotal": null, "dispossessed": null, "dribbleAttempts": null, "dribbleSucc": null, "duelsTotal": null, "duelsWon": null, "foulsCommitted": null, "goals": "0", "goalsConceded": null, "id": "cmr7ob53r6sdirx06thhg0e7k", "image": null, "injured": "No", "insideBoxSaves": null, "interceptions": null, "isActive": true, "isCaptain": false, "keyPasses": null, "matchPlayed": "2", "minutes": null, "name": "A. Da Silva", "number": null, "passes": null, "passesAccuracy": null, "penCommitted": null, "penMissed": null, "penScored": null, "penWon": null, "rating": null, "redCards": "0", "saves": null, "shotsTotal": null, "substituteOut": "0", "substitutesOnBench": "3", "tackles": null, "team": { "badge": "https://media.goal-api.com/badges/3783_moulins-yzeure-foot.jpg", "id": "cmr7ob0k36rbrrx06c0usc4cg", "name": "Moulins Yzeure Foot" }, "teamId": "cmr7ob0k36rbrrx06c0usc4cg", "type": "Defenders", "updatedAt": "2026-07-13T04:20:21.025Z", "woodworks": null, "yellowCards": "0" } ], "query": "silva", "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getPlayersSearch" } }, "/players/compare": { "get": { "tags": [ "Players" ], "summary": "Compare players", "parameters": [ { "name": "ids", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Comma-separated player ids" } ], "responses": { "200": { "description": "Players", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Player" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "comparison": { "attacking": { "assists": { "leader": "(Vsevolod) Sadovski Usevalad", "value": 0 }, "dribbleSucc": { "leader": "(Vsevolod) Sadovski Usevalad", "value": 0 }, "goals": { "leader": "(Vsevolod) Sadovski Usevalad", "value": 0 }, "keyPasses": { "leader": "(Vsevolod) Sadovski Usevalad", "value": 0 }, "shotsTotal": { "leader": "(Vsevolod) Sadovski Usevalad", "value": 0 } }, "defending": { "duelsWon": { "leader": "(Vsevolod) Sadovski Usevalad", "value": 0 }, "interceptions": { "leader": "(Vsevolod) Sadovski Usevalad", "value": 0 }, "tackles": { "leader": "(Vsevolod) Sadovski Usevalad", "value": 0 } }, "discipline": { "redCards": { "leader": "(Vsevolod) Sadovski Usevalad", "value": 0 }, "yellowCards": { "leader": "(Vsevolod) Sadovski Usevalad", "value": 0 } }, "overall": { "matchPlayed": { "leader": "?. Diubea", "value": 1 }, "minutes": { "leader": "(Vsevolod) Sadovski Usevalad", "value": 0 }, "rating": { "leader": "(Vsevolod) Sadovski Usevalad", "value": "N/A" } } }, "count": 2, "data": [ { "age": "29", "country": "N/A", "id": "cmri4pmx1d6lwlb073oxcrciz", "image": "https://media.goal-api.com/badges/players/70549_v-sadovskiy.jpg", "name": "(Vsevolod) Sadovski Usevalad", "number": "90", "position": "Forwards", "stats": { "assists": 0, "dribbleSucc": 0, "duelsWon": 0, "goals": 0, "interceptions": 0, "keyPasses": 0, "matchPlayed": 0, "minutes": 0, "passes": 0, "passesAccuracy": "N/A", "rating": "N/A", "redCards": 0, "shotsTotal": 0, "tackles": 0, "yellowCards": 0 }, "team": "Okzhetpes", "teamBadge": "https://apiv3.apifootball.com/badges/11637_okzhetpes.jpg" }, { "age": "N/A", "country": "N/A", "id": "cmri6v9euea88lb07w0bz6epq", "image": null, "name": "?. Diubea", "number": "N/A", "position": "Defenders", "stats": { "assists": 0, "dribbleSucc": 0, "duelsWon": 0, "goals": 0, "interceptions": 0, "keyPasses": 0, "matchPlayed": 1, "minutes": 0, "passes": 0, "passesAccuracy": "N/A", "rating": "N/A", "redCards": 0, "shotsTotal": 0, "tackles": 0, "yellowCards": 0 }, "team": "Vointa Livezile", "teamBadge": null } ], "source": "cache", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getPlayersCompare" } }, "/players/top/{stat}": { "get": { "tags": [ "Players" ], "summary": "Top players by a statistic", "parameters": [ { "name": "stat", "in": "path", "required": true, "schema": { "$ref": "#/components/schemas/PlayerStat" } }, { "$ref": "#/components/parameters/limit" }, { "name": "teamId", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Ranked players", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/TopPlayer" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 5, "data": [ { "id": "cmr7huzrx3u6hrx067o2pptwf", "image": "https://media.goal-api.com/badges/players/111363_j-makama.jpg", "matchPlayed": 1, "name": "Jovon Makama", "number": "24", "position": "Forwards", "rank": 1, "rating": 10, "team": "Norwich City", "teamBadge": "https://apiv3.apifootball.com/badges/3093_norwich-city.jpg" }, { "id": "cmri6vblleb58lb07829kzkor", "image": null, "matchPlayed": 1, "name": "Alexandru Soare", "number": "33", "position": "Goalkeepers", "rank": 2, "rating": 9.9, "team": "Metaloglobus", "teamBadge": "https://apiv3.apifootball.com/badges/6171_metaloglobus.jpg" } ], "metadata": { "averageValue": "9.56", "filters": { "teamId": null, "type": "All" }, "statName": "rating", "topValue": 10, "totalPlayers": 5 }, "source": "cache", "stat": "rating", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getPlayersTopByStat" } }, "/players/{id}": { "get": { "tags": [ "Players" ], "summary": "Get a player", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Player id" } ], "responses": { "200": { "description": "Player", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "$ref": "#/components/schemas/Player" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": { "age": "29", "apiId": "1477558463", "assists": null, "birthdate": "1996-10-04", "blocks": null, "clearances": null, "country": null, "createdAt": "2026-07-12T18:30:33.255Z", "crossesTotal": null, "dispossessed": null, "dribbleAttempts": null, "dribbleSucc": null, "duelsTotal": null, "duelsWon": null, "foulsCommitted": null, "goals": null, "goalsConceded": null, "id": "cmri4pmx1d6lwlb073oxcrciz", "image": "https://media.goal-api.com/badges/players/70549_v-sadovskiy.jpg", "injured": "No", "insideBoxSaves": null, "interceptions": null, "isActive": true, "isCaptain": false, "keyPasses": null, "matchPlayed": null, "minutes": null, "name": "(Vsevolod) Sadovski Usevalad", "number": "90", "passes": null, "passesAccuracy": null, "penCommitted": null, "penMissed": null, "penScored": null, "penWon": null, "rating": null, "redCards": null, "saves": null, "shotsTotal": null, "statistics": [], "substituteOut": null, "substitutesOnBench": null, "tackles": null, "team": { "badge": "https://media.goal-api.com/badges/11637_okzhetpes.jpg", "country": "Kazakhstan", "id": "cmrikysi4f8ebs107u36g7kqv", "name": "Okzhetpes" }, "teamId": "cmrikysi4f8ebs107u36g7kqv", "type": "Forwards", "updatedAt": "2026-08-05T04:01:22.088Z", "woodworks": null, "yellowCards": null }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getPlayersById" } }, "/players/{id}/statistics": { "get": { "tags": [ "Players" ], "summary": "Player statistics", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Player id" } ], "responses": { "200": { "description": "Statistics", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "$ref": "#/components/schemas/Player" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": { "attacking": { "goalsConceded": 0, "goalsPerMatch": 0, "keyPasses": 0, "penMissed": 0, "penScored": 0, "penWon": 0, "shotsTotal": 0, "woodworks": 0 }, "basic": { "age": "29", "country": "N/A", "injured": "No", "isCaptain": false, "name": "(Vsevolod) Sadovski Usevalad", "number": "90", "position": "Forwards", "team": "Okzhetpes", "teamBadge": "https://apiv3.apifootball.com/badges/11637_okzhetpes.jpg" }, "defending": { "blocks": 0, "clearances": 0, "foulsCommitted": 0, "interceptions": 0, "penCommitted": 0, "tackles": 0 }, "duels": { "dispossessed": 0, "dribbleAttempts": 0, "dribbleSucc": 0, "duelWinRate": 0, "duelsTotal": 0, "duelsWon": 0 }, "goalkeeper": null, "passing": { "crossesTotal": 0, "keyPasses": 0, "passes": 0, "passesAccuracy": "N/A" }, "performance": { "assists": 0, "goals": 0, "matchPlayed": 0, "minutes": 0, "minutesPerMatch": 0, "rating": "N/A", "redCards": 0, "substituteOut": 0, "substitutesOnBench": 0, "yellowCards": 0 }, "recentMatches": [] }, "playerId": "cmri4pmx1d6lwlb073oxcrciz", "source": "cache", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getPlayersByIdStatistics" } }, "/coaches": { "get": { "tags": [ "Coaches" ], "summary": "List coaches", "parameters": [ { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Coaches", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Coach" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": [ { "age": null, "country": null, "createdAt": "2026-07-26T04:38:25.335Z", "id": "cms1b5bh0ajzpkw06ooc9hjtx", "name": "A Popovici", "team": { "badge": "https://media.goal-api.com/badges/27595_campulung-muscel.jpg", "country": "Romania", "id": "cmri6v6ofe9o3lb07qr63v9u9", "name": "Câmpulung Muscel" }, "teamId": "cmri6v6ofe9o3lb07qr63v9u9", "updatedAt": "2026-07-26T04:38:25.335Z" }, { "age": null, "country": null, "createdAt": "2026-08-05T04:24:21.275Z", "id": "cmsfl1qwe7rnrny07aayxivh0", "name": "A, Morić", "team": { "badge": "https://media.goal-api.com/badges/2359_hrvace.jpg", "country": "Croatia", "id": "cmri6uvc2e5nmlb07l5cra5mu", "name": "Hrvace" }, "teamId": "cmri6uvc2e5nmlb07l5cra5mu", "updatedAt": "2026-08-05T04:24:21.275Z" } ], "pagination": { "hasMore": true, "limit": 5, "offset": 0, "total": 8269 }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getCoaches" } }, "/coaches/search": { "get": { "tags": [ "Coaches" ], "summary": "Search coaches by name", "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Matches", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Coach" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 0, "data": [], "query": "guardiola", "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getCoachesSearch" } }, "/coaches/country/{country}": { "get": { "tags": [ "Coaches" ], "summary": "Coaches by nationality", "parameters": [ { "name": "country", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Country name" }, { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Coaches", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Coach" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "country": "England", "data": [], "pagination": { "hasMore": false, "limit": 5, "offset": 0, "total": 0 }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getCoachesCountryByCountry" } }, "/coaches/team/{teamId}": { "get": { "tags": [ "Coaches" ], "summary": "Coach of a team", "parameters": [ { "name": "teamId", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Team id" } ], "responses": { "200": { "description": "Coaches", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Coach" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 0, "data": [], "source": "database", "success": true, "team": { "badge": "https://media.goal-api.com/badges/13176_s-gravenwezel-schilde.jpg", "country": "Belgium", "id": "cmri4qwgddrcqlb07pghzlize", "name": "'s Gravenwezel-Schilde" }, "teamId": "cmri4qwgddrcqlb07pghzlize" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getCoachesTeamByTeamId" } }, "/coaches/{id}": { "get": { "tags": [ "Coaches" ], "summary": "Get a coach", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Coach id" } ], "responses": { "200": { "description": "Coach", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "$ref": "#/components/schemas/Coach" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": { "age": null, "country": null, "createdAt": "2026-07-26T04:38:25.335Z", "id": "cms1b5bh0ajzpkw06ooc9hjtx", "name": "A Popovici", "team": { "badge": "https://media.goal-api.com/badges/27595_campulung-muscel.jpg", "country": "Romania", "founded": "2022", "id": "cmri6v6ofe9o3lb07qr63v9u9", "name": "Câmpulung Muscel", "venueCity": null, "venueName": null }, "teamId": "cmri6v6ofe9o3lb07qr63v9u9", "updatedAt": "2026-07-26T04:38:25.335Z" }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getCoachesById" } }, "/standings/{leagueId}": { "get": { "tags": [ "Standings" ], "summary": "League table", "parameters": [ { "name": "leagueId", "in": "path", "required": true, "schema": { "type": "string" }, "description": "League id" } ], "responses": { "200": { "description": "Table", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Standing" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 16, "data": [ { "awayLeagueD": null, "awayLeagueGA": null, "awayLeagueGF": null, "awayLeagueL": null, "awayLeaguePTS": null, "awayLeaguePlayed": null, "awayLeaguePosition": null, "awayLeagueW": null, "awayPromotion": null, "createdAt": "2026-07-05T07:52:03.630Z", "fkStageKey": "85", "homeLeagueD": null, "homeLeagueGA": null, "homeLeagueGF": null, "homeLeagueL": null, "homeLeaguePTS": null, "homeLeaguePlayed": null, "homeLeaguePosition": null, "homeLeagueW": null, "homePromotion": null, "id": "cmr7htgd13d4brx06r0fosjav", "league": { "id": "cmr77dvhg0018rx06z11d3k9z", "name": "CONMEBOL Copa America", "season": "2024" }, "leagueId": "cmr77dvhg0018rx06z11d3k9z", "leagueRound": "Group A", "overallLeagueD": "0", "overallLeagueGA": "0", "overallLeagueGF": "5", "overallLeagueL": "0", "overallLeaguePTS": "9", "overallLeaguePlayed": "3", "overallLeaguePosition": "1", "overallLeagueW": "3", "overallPromotion": "Promotion - Copa América (Play Offs: Quarter-finals)", "season": null, "stageName": "Group Stage", "team": { "badge": "https://media.goal-api.com/badges/536_argentina.jpg", "country": "Argentina", "id": "cmr7becf20u8zrx06zt8asrlw", "name": "Argentina" }, "teamId": "cmr7becf20u8zrx06zt8asrlw", "teamName": "Argentina", "updatedAt": "2026-07-05T07:52:03.630Z" }, { "awayLeagueD": null, "awayLeagueGA": null, "awayLeagueGF": null, "awayLeagueL": null, "awayLeaguePTS": null, "awayLeaguePlayed": null, "awayLeaguePosition": null, "awayLeagueW": null, "awayPromotion": null, "createdAt": "2026-07-05T07:52:03.630Z", "fkStageKey": "85", "homeLeagueD": null, "homeLeagueGA": null, "homeLeagueGF": null, "homeLeagueL": null, "homeLeaguePTS": null, "homeLeaguePlayed": null, "homeLeaguePosition": null, "homeLeagueW": null, "homePromotion": null, "id": "cmr7htgd23d4frx06u9s2woya", "league": { "id": "cmr77dvhg0018rx06z11d3k9z", "name": "CONMEBOL Copa America", "season": "2024" }, "leagueId": "cmr77dvhg0018rx06z11d3k9z", "leagueRound": "Group B", "overallLeagueD": "0", "overallLeagueGA": "1", "overallLeagueGF": "6", "overallLeagueL": "0", "overallLeaguePTS": "9", "overallLeaguePlayed": "3", "overallLeaguePosition": "1", "overallLeagueW": "3", "overallPromotion": "Promotion - Copa América (Play Offs: Quarter-finals)", "season": null, "stageName": "Group Stage", "team": { "badge": "https://media.goal-api.com/badges/532_venezuela.jpg", "country": "Venezuela", "id": "cmr7becfb0u98rx06n9kbjdhm", "name": "Venezuela" }, "teamId": "cmr7becfb0u98rx06n9kbjdhm", "teamName": "Venezuela", "updatedAt": "2026-07-05T07:52:03.630Z" } ], "leagueId": "cmr77dvhg0018rx06z11d3k9z", "source": "cache", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getStandingsByLeagueId" } }, "/standings/{leagueId}/home": { "get": { "tags": [ "Standings" ], "summary": "Home-only table", "parameters": [ { "name": "leagueId", "in": "path", "required": true, "schema": { "type": "string" }, "description": "League id" } ], "responses": { "200": { "description": "Home table", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/SplitStanding" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 64, "data": [ { "awayLeagueD": "0", "awayLeagueGA": "0", "awayLeagueGF": "0", "awayLeagueL": "0", "awayLeaguePTS": "0", "awayLeaguePlayed": "0", "awayLeaguePosition": "25", "awayLeagueW": "0", "awayPromotion": null, "createdAt": "2026-07-05T07:52:04.861Z", "draws": 0, "fkStageKey": "86", "goalsAgainst": 0, "goalsFor": 1, "homeLeagueD": "0", "homeLeagueGA": "0", "homeLeagueGF": "1", "homeLeagueL": "0", "homeLeaguePTS": "3", "homeLeaguePlayed": "1", "homeLeaguePosition": "1", "homeLeagueW": "1", "homePromotion": null, "id": "cmr7htgy43dcfrx06bpcbygqb", "league": { "id": "cmr77dvhg0019rx06c0fx6cwh", "name": "CONMEBOL Libertadores", "season": "2026" }, "leagueId": "cmr77dvhg0019rx06c0fx6cwh", "leagueRound": "Group C", "losses": 0, "overallLeagueD": "0", "overallLeagueGA": "0", "overallLeagueGF": "1", "overallLeagueL": "0", "overallLeaguePTS": "3", "overallLeaguePlayed": "1", "overallLeaguePosition": "1", "overallLeagueW": "1", "overallPromotion": "Promotion - Copa Libertadores (Play Offs: 1/8-finals)", "played": 1, "points": 3, "position": 1, "season": null, "stageName": "Group Stage", "team": { "badge": "https://media.goal-api.com/badges/947_independiente-rivadavia.jpg", "country": "Argentina", "id": "cmr7ben820y51rx061jqfuigv", "name": "Independiente Rivadavia" }, "teamId": "cmr7ben820y51rx061jqfuigv", "teamName": "Ind. Rivadavia", "updatedAt": "2026-07-05T07:52:04.861Z", "wins": 1 }, { "awayLeagueD": "1", "awayLeagueGA": "1", "awayLeagueGF": "6", "awayLeagueL": "0", "awayLeaguePTS": "7", "awayLeaguePlayed": "3", "awayLeaguePosition": "3", "awayLeagueW": "2", "awayPromotion": null, "createdAt": "2026-07-05T07:52:04.861Z", "draws": 0, "fkStageKey": "2181", "goalsAgainst": 1, "goalsFor": 8, "homeLeagueD": "0", "homeLeagueGA": "1", "homeLeagueGF": "8", "homeLeagueL": "0", "homeLeaguePTS": "9", "homeLeaguePlayed": "3", "homeLeaguePosition": "1", "homeLeagueW": "3", "homePromotion": null, "id": "cmr7htgy83dd3rx06wxbwmg7x", "league": { "id": "cmr77dvhg0019rx06c0fx6cwh", "name": "CONMEBOL Libertadores", "season": "2026" }, "leagueId": "cmr77dvhg0019rx06c0fx6cwh", "leagueRound": "Group A", "losses": 0, "overallLeagueD": "1", "overallLeagueGA": "2", "overallLeagueGF": "14", "overallLeagueL": "0", "overallLeaguePTS": "16", "overallLeaguePlayed": "6", "overallLeaguePosition": "1", "overallLeagueW": "5", "overallPromotion": "Promotion - Copa Libertadores (Play Offs: 1/8-finals)", "played": 3, "points": 9, "position": 1, "season": null, "stageName": "Regular Season", "team": { "badge": "https://media.goal-api.com/badges/542_flamengo.jpg", "country": "Brazil", "id": "cmr7ben4v0y3wrx06tu6j4ewh", "name": "Flamengo" }, "teamId": "cmr7ben4v0y3wrx06tu6j4ewh", "teamName": "Flamengo RJ", "updatedAt": "2026-07-05T07:52:04.861Z", "wins": 3 } ], "leagueId": "cmr77dvhg0019rx06c0fx6cwh", "source": "cache", "success": true, "type": "home" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getStandingsByLeagueIdHome" } }, "/standings/{leagueId}/away": { "get": { "tags": [ "Standings" ], "summary": "Away-only table", "parameters": [ { "name": "leagueId", "in": "path", "required": true, "schema": { "type": "string" }, "description": "League id" } ], "responses": { "200": { "description": "Away table", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/SplitStanding" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 64, "data": [ { "awayLeagueD": "0", "awayLeagueGA": "4", "awayLeagueGF": "9", "awayLeagueL": "0", "awayLeaguePTS": "9", "awayLeaguePlayed": "3", "awayLeaguePosition": "1", "awayLeagueW": "3", "awayPromotion": null, "createdAt": "2026-07-05T07:52:04.861Z", "draws": 0, "fkStageKey": "2181", "goalsAgainst": 4, "goalsFor": 9, "homeLeagueD": "1", "homeLeagueGA": "2", "homeLeagueGF": "6", "homeLeagueL": "0", "homeLeaguePTS": "7", "homeLeaguePlayed": "3", "homeLeaguePosition": "9", "homeLeagueW": "2", "homePromotion": null, "id": "cmr7htgy93ddbrx06hfg56okv", "league": { "id": "cmr77dvhg0019rx06c0fx6cwh", "name": "CONMEBOL Libertadores", "season": "2026" }, "leagueId": "cmr77dvhg0019rx06c0fx6cwh", "leagueRound": "Group C", "losses": 0, "overallLeagueD": "1", "overallLeagueGA": "6", "overallLeagueGF": "15", "overallLeagueL": "0", "overallLeaguePTS": "16", "overallLeaguePlayed": "6", "overallLeaguePosition": "1", "overallLeagueW": "5", "overallPromotion": "Promotion - Copa Libertadores (Play Offs: 1/8-finals)", "played": 3, "points": 9, "position": 1, "season": null, "stageName": "Regular Season", "team": { "badge": "https://media.goal-api.com/badges/947_independiente-rivadavia.jpg", "country": "Argentina", "id": "cmr7ben820y51rx061jqfuigv", "name": "Independiente Rivadavia" }, "teamId": "cmr7ben820y51rx061jqfuigv", "teamName": "Ind. Rivadavia", "updatedAt": "2026-07-05T07:52:04.861Z", "wins": 3 }, { "awayLeagueD": "0", "awayLeagueGA": "0", "awayLeagueGF": "1", "awayLeagueL": "0", "awayLeaguePTS": "3", "awayLeaguePlayed": "1", "awayLeaguePosition": "1", "awayLeagueW": "1", "awayPromotion": null, "createdAt": "2026-07-05T07:52:04.861Z", "draws": 0, "fkStageKey": "86", "goalsAgainst": 0, "goalsFor": 1, "homeLeagueD": "0", "homeLeagueGA": "0", "homeLeagueGF": "0", "homeLeagueL": "0", "homeLeaguePTS": "0", "homeLeaguePlayed": "0", "homeLeaguePosition": "20", "homeLeagueW": "0", "homePromotion": null, "id": "cmr7htgy53dckrx06v5yq9u23", "league": { "id": "cmr77dvhg0019rx06c0fx6cwh", "name": "CONMEBOL Libertadores", "season": "2026" }, "leagueId": "cmr77dvhg0019rx06c0fx6cwh", "leagueRound": "Group D", "losses": 0, "overallLeagueD": "0", "overallLeagueGA": "0", "overallLeagueGF": "1", "overallLeagueL": "0", "overallLeaguePTS": "3", "overallLeaguePlayed": "1", "overallLeaguePosition": "2", "overallLeagueW": "1", "overallPromotion": "Promotion - Copa Libertadores (Play Offs: 1/8-finals)", "played": 1, "points": 3, "position": 1, "season": null, "stageName": "Group Stage", "team": { "badge": "https://media.goal-api.com/badges/1745_cruzeiro.jpg", "country": "Brazil", "id": "cmr7ben550y3zrx06zvi1dus9", "name": "Cruzeiro" }, "teamId": "cmr7ben550y3zrx06zvi1dus9", "teamName": "Cruzeiro", "updatedAt": "2026-07-05T07:52:04.861Z", "wins": 1 } ], "leagueId": "cmr77dvhg0019rx06c0fx6cwh", "source": "database", "success": true, "type": "away" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getStandingsByLeagueIdAway" } }, "/standings/{leagueId}/form": { "get": { "tags": [ "Standings" ], "summary": "Table ordered by recent form", "parameters": [ { "name": "leagueId", "in": "path", "required": true, "schema": { "type": "string" }, "description": "League id" } ], "responses": { "200": { "description": "Form table", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Standing" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 16, "data": [ { "awayLeagueD": null, "awayLeagueGA": null, "awayLeagueGF": null, "awayLeagueL": null, "awayLeaguePTS": null, "awayLeaguePlayed": null, "awayLeaguePosition": null, "awayLeagueW": null, "awayPromotion": null, "createdAt": "2026-07-05T07:52:03.630Z", "fkStageKey": "85", "formGuide": { "drawPercentage": 0, "draws": 0, "goalsAgainst": 0, "goalsFor": 5, "lossPercentage": 0, "losses": 0, "played": 3, "points": 9, "winPercentage": 100, "wins": 3 }, "formPercentage": 100, "goalDifference": 5, "homeLeagueD": null, "homeLeagueGA": null, "homeLeagueGF": null, "homeLeagueL": null, "homeLeaguePTS": null, "homeLeaguePlayed": null, "homeLeaguePosition": null, "homeLeagueW": null, "homePromotion": null, "id": "cmr7htgd13d4brx06r0fosjav", "league": { "id": "cmr77dvhg0018rx06z11d3k9z", "name": "CONMEBOL Copa America", "season": "2024" }, "leagueId": "cmr77dvhg0018rx06z11d3k9z", "leagueRound": "Group A", "overallLeagueD": "0", "overallLeagueGA": "0", "overallLeagueGF": "5", "overallLeagueL": "0", "overallLeaguePTS": "9", "overallLeaguePlayed": "3", "overallLeaguePosition": "1", "overallLeagueW": "3", "overallPromotion": "Promotion - Copa América (Play Offs: Quarter-finals)", "pointsPerGame": 3, "season": null, "stageName": "Group Stage", "team": { "badge": "https://media.goal-api.com/badges/536_argentina.jpg", "country": "Argentina", "id": "cmr7becf20u8zrx06zt8asrlw", "name": "Argentina" }, "teamId": "cmr7becf20u8zrx06zt8asrlw", "teamName": "Argentina", "updatedAt": "2026-07-05T07:52:03.630Z" }, { "awayLeagueD": null, "awayLeagueGA": null, "awayLeagueGF": null, "awayLeagueL": null, "awayLeaguePTS": null, "awayLeaguePlayed": null, "awayLeaguePosition": null, "awayLeagueW": null, "awayPromotion": null, "createdAt": "2026-07-05T07:52:03.630Z", "fkStageKey": "85", "formGuide": { "drawPercentage": 0, "draws": 0, "goalsAgainst": 1, "goalsFor": 6, "lossPercentage": 0, "losses": 0, "played": 3, "points": 9, "winPercentage": 100, "wins": 3 }, "formPercentage": 100, "goalDifference": 5, "homeLeagueD": null, "homeLeagueGA": null, "homeLeagueGF": null, "homeLeagueL": null, "homeLeaguePTS": null, "homeLeaguePlayed": null, "homeLeaguePosition": null, "homeLeagueW": null, "homePromotion": null, "id": "cmr7htgd23d4frx06u9s2woya", "league": { "id": "cmr77dvhg0018rx06z11d3k9z", "name": "CONMEBOL Copa America", "season": "2024" }, "leagueId": "cmr77dvhg0018rx06z11d3k9z", "leagueRound": "Group B", "overallLeagueD": "0", "overallLeagueGA": "1", "overallLeagueGF": "6", "overallLeagueL": "0", "overallLeaguePTS": "9", "overallLeaguePlayed": "3", "overallLeaguePosition": "1", "overallLeagueW": "3", "overallPromotion": "Promotion - Copa América (Play Offs: Quarter-finals)", "pointsPerGame": 3, "season": null, "stageName": "Group Stage", "team": { "badge": "https://media.goal-api.com/badges/532_venezuela.jpg", "country": "Venezuela", "id": "cmr7becfb0u98rx06n9kbjdhm", "name": "Venezuela" }, "teamId": "cmr7becfb0u98rx06n9kbjdhm", "teamName": "Venezuela", "updatedAt": "2026-07-05T07:52:03.630Z" } ], "leagueId": "cmr77dvhg0018rx06z11d3k9z", "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getStandingsByLeagueIdForm" } }, "/standings/{leagueId}/zones": { "get": { "tags": [ "Standings" ], "summary": "Promotion and relegation zones", "parameters": [ { "name": "leagueId", "in": "path", "required": true, "schema": { "type": "string" }, "description": "League id" } ], "responses": { "200": { "description": "Zones", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "$ref": "#/components/schemas/StandingZones" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": { "leagueId": "cmr77dvhg0018rx06z11d3k9z", "summary": { "europeanZone": 0, "promotionZone": 0, "relegationPlayoffZone": 0, "relegationZone": 0, "safeZone": 16, "totalTeams": 16 }, "zones": { "europeanQualification": [], "promotion": [], "relegation": [], "relegationPlayoff": [], "safe": [ { "awayLeagueD": null, "awayLeagueGA": null, "awayLeagueGF": null, "awayLeagueL": null, "awayLeaguePTS": null, "awayLeaguePlayed": null, "awayLeaguePosition": null, "awayLeagueW": null, "awayPromotion": null, "createdAt": "2026-07-05T07:52:03.630Z", "fkStageKey": "85", "homeLeagueD": null, "homeLeagueGA": null, "homeLeagueGF": null, "homeLeagueL": null, "homeLeaguePTS": null, "homeLeaguePlayed": null, "homeLeaguePosition": null, "homeLeagueW": null, "homePromotion": null, "id": "cmr7htgd13d4brx06r0fosjav", "league": { "id": "cmr77dvhg0018rx06z11d3k9z", "name": "CONMEBOL Copa America", "season": "2024" }, "leagueId": "cmr77dvhg0018rx06z11d3k9z", "leagueRound": "Group A", "overallLeagueD": "0", "overallLeagueGA": "0", "overallLeagueGF": "5", "overallLeagueL": "0", "overallLeaguePTS": "9", "overallLeaguePlayed": "3", "overallLeaguePosition": "1", "overallLeagueW": "3", "overallPromotion": "Promotion - Copa América (Play Offs: Quarter-finals)", "season": null, "stageName": "Group Stage", "team": { "badge": "https://media.goal-api.com/badges/536_argentina.jpg", "country": "Argentina", "id": "cmr7becf20u8zrx06zt8asrlw", "name": "Argentina" }, "teamId": "cmr7becf20u8zrx06zt8asrlw", "teamName": "Argentina", "updatedAt": "2026-07-05T07:52:03.630Z" }, { "awayLeagueD": null, "awayLeagueGA": null, "awayLeagueGF": null, "awayLeagueL": null, "awayLeaguePTS": null, "awayLeaguePlayed": null, "awayLeaguePosition": null, "awayLeagueW": null, "awayPromotion": null, "createdAt": "2026-07-05T07:52:03.630Z", "fkStageKey": "85", "homeLeagueD": null, "homeLeagueGA": null, "homeLeagueGF": null, "homeLeagueL": null, "homeLeaguePTS": null, "homeLeaguePlayed": null, "homeLeaguePosition": null, "homeLeagueW": null, "homePromotion": null, "id": "cmr7htgd23d4frx06u9s2woya", "league": { "id": "cmr77dvhg0018rx06z11d3k9z", "name": "CONMEBOL Copa America", "season": "2024" }, "leagueId": "cmr77dvhg0018rx06z11d3k9z", "leagueRound": "Group B", "overallLeagueD": "0", "overallLeagueGA": "1", "overallLeagueGF": "6", "overallLeagueL": "0", "overallLeaguePTS": "9", "overallLeaguePlayed": "3", "overallLeaguePosition": "1", "overallLeagueW": "3", "overallPromotion": "Promotion - Copa América (Play Offs: Quarter-finals)", "season": null, "stageName": "Group Stage", "team": { "badge": "https://media.goal-api.com/badges/532_venezuela.jpg", "country": "Venezuela", "id": "cmr7becfb0u98rx06n9kbjdhm", "name": "Venezuela" }, "teamId": "cmr7becfb0u98rx06n9kbjdhm", "teamName": "Venezuela", "updatedAt": "2026-07-05T07:52:03.630Z" } ] } }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getStandingsByLeagueIdZones" } }, "/standings/{leagueId}/team/{teamId}": { "get": { "tags": [ "Standings" ], "summary": "One team's table row", "parameters": [ { "name": "leagueId", "in": "path", "required": true, "schema": { "type": "string" }, "description": "League id" }, { "name": "teamId", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Team id" } ], "responses": { "200": { "description": "Row", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "$ref": "#/components/schemas/Standing" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": { "awayLeagueD": null, "awayLeagueGA": null, "awayLeagueGF": null, "awayLeagueL": null, "awayLeaguePTS": null, "awayLeaguePlayed": null, "awayLeaguePosition": null, "awayLeagueW": null, "awayPromotion": null, "createdAt": "2026-07-05T07:52:03.630Z", "fkStageKey": "85", "homeLeagueD": null, "homeLeagueGA": null, "homeLeagueGF": null, "homeLeagueL": null, "homeLeaguePTS": null, "homeLeaguePlayed": null, "homeLeaguePosition": null, "homeLeagueW": null, "homePromotion": null, "id": "cmr7htgd13d4brx06r0fosjav", "league": { "id": "cmr77dvhg0018rx06z11d3k9z", "name": "CONMEBOL Copa America", "season": "2024" }, "leagueId": "cmr77dvhg0018rx06z11d3k9z", "leagueRound": "Group A", "overallLeagueD": "0", "overallLeagueGA": "0", "overallLeagueGF": "5", "overallLeagueL": "0", "overallLeaguePTS": "9", "overallLeaguePlayed": "3", "overallLeaguePosition": "1", "overallLeagueW": "3", "overallPromotion": "Promotion - Copa América (Play Offs: Quarter-finals)", "season": null, "stageName": "Group Stage", "team": { "badge": "https://media.goal-api.com/badges/536_argentina.jpg", "country": "Argentina", "id": "cmr7becf20u8zrx06zt8asrlw", "name": "Argentina" }, "teamId": "cmr7becf20u8zrx06zt8asrlw", "teamName": "Argentina", "updatedAt": "2026-07-05T07:52:03.630Z" }, "leagueId": "cmr77dvhg0018rx06z11d3k9z", "source": "database", "success": true, "teamId": "cmr7becf20u8zrx06zt8asrlw" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getStandingsByLeagueIdTeamByTeamId" } }, "/h2h/{team1Id}/{team2Id}": { "get": { "tags": [ "Head to head" ], "summary": "Previous meetings and recent form", "parameters": [ { "name": "team1Id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "First team id" }, { "name": "team2Id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Second team id" } ], "responses": { "200": { "description": "H2H", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "$ref": "#/components/schemas/HeadToHead" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": { "createdAt": "2026-07-15T08:55:13.156Z", "directMatches": [ { "country_id": "8", "country_logo": "", "country_name": "Worldcup", "league_id": "27", "league_logo": "https://apiv3.apifootball.com/badges/logo_leagues/27_wc-qualification-south-america.png", "league_name": "CONMEBOL World Cup Qualifiers", "match_awayteam_halftime_score": "1", "match_awayteam_id": "535", "match_awayteam_name": "Colombia", "match_awayteam_score": "1", "match_date": "2025-06-11", "match_hometeam_halftime_score": "0", "match_hometeam_id": "536", "match_hometeam_name": "Argentina", "match_hometeam_score": "1", "match_id": "271020", "match_live": "0", "match_status": "Finished", "match_time": "02:00", "team_away_badge": "https://apiv3.apifootball.com/badges/535_colombia.jpg", "team_home_badge": "https://apiv3.apifootball.com/badges/536_argentina.jpg" }, { "country_id": "8", "country_logo": "", "country_name": "Worldcup", "league_id": "27", "league_logo": "https://apiv3.apifootball.com/badges/logo_leagues/27_wc-qualification-south-america.png", "league_name": "CONMEBOL World Cup Qualifiers", "match_awayteam_halftime_score": "0", "match_awayteam_id": "536", "match_awayteam_name": "Argentina", "match_awayteam_score": "1", "match_date": "2024-09-10", "match_hometeam_halftime_score": "1", "match_hometeam_id": "535", "match_hometeam_name": "Colombia", "match_hometeam_score": "2", "match_id": "270980", "match_live": "0", "match_status": "Finished", "match_time": "22:30", "team_away_badge": "https://apiv3.apifootball.com/badges/536_argentina.jpg", "team_home_badge": "https://apiv3.apifootball.com/badges/535_colombia.jpg" } ], "id": "cmrluh6o423cwru07o8pbzsw2", "lastUpdated": "2026-07-15T08:55:13.150Z", "team1Id": "cmr7becf00u8xrx06mm08zlqn", "team1Name": "Colombia", "team1Recent": [ { "country_id": "8", "country_logo": "", "country_name": "Worldcup", "league_id": "28", "league_logo": "https://apiv3.apifootball.com/badges/logo_leagues/28_world-cup.png", "league_name": "World Cup", "match_awayteam_halftime_score": "0", "match_awayteam_id": "725", "match_awayteam_name": "Ghana", "match_awayteam_score": "0", "match_date": "2026-07-04", "match_hometeam_halftime_score": "1", "match_hometeam_id": "535", "match_hometeam_name": "Colombia", "match_hometeam_score": "1", "match_id": "770009", "match_live": "0", "match_status": "Finished", "match_time": "03:30", "team_away_badge": "https://apiv3.apifootball.com/badges/725_ghana.jpg", "team_home_badge": "https://apiv3.apifootball.com/badges/535_colombia.jpg" }, { "country_id": "8", "country_logo": "", "country_name": "Worldcup", "league_id": "28", "league_logo": "https://apiv3.apifootball.com/badges/logo_leagues/28_world-cup.png", "league_name": "World Cup", "match_awayteam_halftime_score": "0", "match_awayteam_id": "23", "match_awayteam_name": "Portugal", "match_awayteam_score": "0", "match_date": "2026-06-28", "match_hometeam_halftime_score": "0", "match_hometeam_id": "535", "match_hometeam_name": "Colombia", "match_hometeam_score": "0", "match_id": "710331", "match_live": "0", "match_status": "Finished", "match_time": "01:30", "team_away_badge": "https://apiv3.apifootball.com/badges/23_portugal.jpg", "team_home_badge": "https://apiv3.apifootball.com/badges/535_colombia.jpg" } ], "team2Id": "cmr7becf20u8zrx06zt8asrlw", "team2Name": "Argentina", "team2Recent": [ { "country_id": "8", "country_logo": "", "country_name": "Worldcup", "league_id": "28", "league_logo": "https://apiv3.apifootball.com/badges/logo_leagues/28_world-cup.png", "league_name": "World Cup", "match_awayteam_halftime_score": "1", "match_awayteam_id": "716", "match_awayteam_name": "Egypt", "match_awayteam_score": "2", "match_date": "2026-07-07", "match_hometeam_halftime_score": "0", "match_hometeam_id": "536", "match_hometeam_name": "Argentina", "match_hometeam_score": "3", "match_id": "771497", "match_live": "0", "match_status": "Finished", "match_time": "18:00", "team_away_badge": "https://apiv3.apifootball.com/badges/716_egypt.jpg", "team_home_badge": "https://apiv3.apifootball.com/badges/536_argentina.jpg" }, { "country_id": "8", "country_logo": "", "country_name": "Worldcup", "league_id": "28", "league_logo": "https://apiv3.apifootball.com/badges/logo_leagues/28_world-cup.png", "league_name": "World Cup", "match_awayteam_halftime_score": "2", "match_awayteam_id": "536", "match_awayteam_name": "Argentina", "match_awayteam_score": "3", "match_date": "2026-06-28", "match_hometeam_halftime_score": "0", "match_hometeam_id": "641", "match_hometeam_name": "Jordan", "match_hometeam_score": "1", "match_id": "710333", "match_live": "0", "match_status": "Finished", "match_time": "04:00", "team_away_badge": "https://apiv3.apifootball.com/badges/536_argentina.jpg", "team_home_badge": "https://apiv3.apifootball.com/badges/641_jordan.jpg" } ], "updatedAt": "2026-07-15T08:55:13.156Z" }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getH2hByTeam1IdByTeam2Id" } }, "/h2h/{team1Id}/{team2Id}/direct": { "get": { "tags": [ "Head to head" ], "summary": "Direct meetings only", "parameters": [ { "name": "team1Id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "First team id" }, { "name": "team2Id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Second team id" } ], "responses": { "200": { "description": "H2H", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "$ref": "#/components/schemas/HeadToHead" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": { "count": 4, "lastUpdated": "2026-07-15T08:55:13.150Z", "matches": [ { "country_id": "8", "country_logo": "", "country_name": "Worldcup", "league_id": "27", "league_logo": "https://apiv3.apifootball.com/badges/logo_leagues/27_wc-qualification-south-america.png", "league_name": "CONMEBOL World Cup Qualifiers", "match_awayteam_halftime_score": "1", "match_awayteam_id": "535", "match_awayteam_name": "Colombia", "match_awayteam_score": "1", "match_date": "2025-06-11", "match_hometeam_halftime_score": "0", "match_hometeam_id": "536", "match_hometeam_name": "Argentina", "match_hometeam_score": "1", "match_id": "271020", "match_live": "0", "match_status": "Finished", "match_time": "02:00", "team_away_badge": "https://apiv3.apifootball.com/badges/535_colombia.jpg", "team_home_badge": "https://apiv3.apifootball.com/badges/536_argentina.jpg" }, { "country_id": "8", "country_logo": "", "country_name": "Worldcup", "league_id": "27", "league_logo": "https://apiv3.apifootball.com/badges/logo_leagues/27_wc-qualification-south-america.png", "league_name": "CONMEBOL World Cup Qualifiers", "match_awayteam_halftime_score": "0", "match_awayteam_id": "536", "match_awayteam_name": "Argentina", "match_awayteam_score": "1", "match_date": "2024-09-10", "match_hometeam_halftime_score": "1", "match_hometeam_id": "535", "match_hometeam_name": "Colombia", "match_hometeam_score": "2", "match_id": "270980", "match_live": "0", "match_status": "Finished", "match_time": "22:30", "team_away_badge": "https://apiv3.apifootball.com/badges/536_argentina.jpg", "team_home_badge": "https://apiv3.apifootball.com/badges/535_colombia.jpg" } ], "statistics": { "averageGoals": 2.5, "draws": 2, "team1Goals": 4, "team1Wins": 0, "team2Goals": 6, "team2Wins": 2, "totalMatches": 4 }, "team1": { "id": "cmr7becf00u8xrx06mm08zlqn", "name": "Colombia" }, "team2": { "id": "cmr7becf20u8zrx06zt8asrlw", "name": "Argentina" } }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getH2hByTeam1IdByTeam2IdDirect" } }, "/h2h/{team1Id}/{team2Id}/stats": { "get": { "tags": [ "Head to head" ], "summary": "Aggregate head-to-head record", "parameters": [ { "name": "team1Id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "First team id" }, { "name": "team2Id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Second team id" } ], "responses": { "200": { "description": "H2H stats", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "$ref": "#/components/schemas/HeadToHead" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": { "comparison": { "formAdvantage": "Even", "scoringAdvantage": "Argentina", "winRateAdvantage": "Argentina" }, "headToHead": { "averageGoals": 2.5, "draws": 2, "goalsPerMatch": 2.5, "lastMeeting": { "country_id": "8", "country_logo": "", "country_name": "Worldcup", "league_id": "27", "league_logo": "https://apiv3.apifootball.com/badges/logo_leagues/27_wc-qualification-south-america.png", "league_name": "CONMEBOL World Cup Qualifiers", "match_awayteam_halftime_score": "1", "match_awayteam_id": "535", "match_awayteam_name": "Colombia", "match_awayteam_score": "1", "match_date": "2025-06-11", "match_hometeam_halftime_score": "0", "match_hometeam_id": "536", "match_hometeam_name": "Argentina", "match_hometeam_score": "1", "match_id": "271020", "match_live": "0", "match_status": "Finished", "match_time": "02:00", "team_away_badge": "https://apiv3.apifootball.com/badges/535_colombia.jpg", "team_home_badge": "https://apiv3.apifootball.com/badges/536_argentina.jpg" }, "team1Goals": 4, "team1Wins": 0, "team2Goals": 6, "team2Wins": 2, "totalMatches": 4 }, "lastUpdated": "2026-07-15T08:55:13.150Z", "recentForm": { "team1": { "averageGoalsAgainst": 1.5, "averageGoalsFor": 1, "draws": 1, "formString": "LDLWL", "goalDifference": -5, "goalsAgainst": 15, "goalsFor": 10, "losses": 6, "matches": 10, "points": 10, "winPercentage": 30, "wins": 3 }, "team2": { "averageGoalsAgainst": 2.1, "averageGoalsFor": 1.4, "draws": 0, "formString": "LWLLL", "goalDifference": -7, "goalsAgainst": 21, "goalsFor": 14, "losses": 7, "matches": 10, "points": 9, "winPercentage": 30, "wins": 3 } }, "teams": { "team1": { "id": "cmr7becf00u8xrx06mm08zlqn", "name": "Colombia" }, "team2": { "id": "cmr7becf20u8zrx06zt8asrlw", "name": "Argentina" } } }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getH2hByTeam1IdByTeam2IdStats" } }, "/videos": { "get": { "tags": [ "Videos" ], "summary": "List highlight videos", "parameters": [ { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Videos", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Video" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": [ { "apiId": "1784172020068", "createdAt": "2026-07-16T03:20:15.041Z", "fixture": { "awayTeamName": "PSG", "awayTeamScore": "1", "homeTeamName": "Arsenal", "homeTeamScore": "0", "id": "cmrji3frni3tco8071qcdlm6b", "league": { "id": "cmr77dw3900f5rx06j05wgzv4", "logo": "https://media.goal-api.com/badges/logo_leagues/3_uefa-champions-league.png", "name": "UEFA Champions League" }, "matchDate": "2025-04-29", "matchTime": "21:00" }, "fixtureId": "cmrji3frni3tco8071qcdlm6b", "id": "cmrmxy9j95ctct007co2bxnrj", "title": "Highlights", "titleFull": "Highlights", "updatedAt": "2026-07-16T03:20:15.033Z", "url": "https://www.g-video.tv/6048579.mp4" }, { "apiId": "1784172021890", "createdAt": "2026-07-16T03:20:12.957Z", "fixture": { "awayTeamName": "Cagliari", "awayTeamScore": "2", "homeTeamName": "Verona", "homeTeamScore": "0", "id": "cmrji3dgshx97o807sfnpehsv", "league": { "id": "cmr77dvpd006yrx06zig7907g", "logo": "https://media.goal-api.com/badges/logo_leagues/207_serie-a.png", "name": "Serie A" }, "matchDate": "2025-04-28", "matchTime": "20:45" }, "fixtureId": "cmrji3dgshx97o807sfnpehsv", "id": "cmrmxy7x95ctat0074v29b67j", "title": "Highlights", "titleFull": "Highlights", "updatedAt": "2026-07-16T03:20:12.955Z", "url": "https://www.g-video.tv/6045986.mp4" } ], "pagination": { "hasMore": true, "limit": 5, "offset": 0, "total": 13414 }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getVideos" } }, "/videos/recent": { "get": { "tags": [ "Videos" ], "summary": "Recent highlights", "parameters": [ { "$ref": "#/components/parameters/limit" } ], "responses": { "200": { "description": "Videos", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Video" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 0, "data": [], "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getVideosRecent" } }, "/videos/match/{matchId}": { "get": { "tags": [ "Videos" ], "summary": "Highlights for a match", "parameters": [ { "name": "matchId", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Fixture id" } ], "responses": { "200": { "description": "Videos", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Video" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "count": 0, "data": [], "matchId": "cmsfbnv0b7t2vuj072522zpo9", "message": "No videos available for this match", "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getVideosMatchByMatchId" } }, "/videos/league/{leagueId}": { "get": { "tags": [ "Videos" ], "summary": "Highlights for a competition", "parameters": [ { "name": "leagueId", "in": "path", "required": true, "schema": { "type": "string" }, "description": "League id" }, { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Videos", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Video" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": [ { "apiId": "1784170368815", "createdAt": "2026-07-16T02:52:48.621Z", "fixture": { "awayTeamName": "Colombia", "awayTeamScore": "1", "homeTeamName": "Uruguay", "homeTeamScore": "0", "id": "cmrjj80u8e79go807sktlxpz1", "league": { "id": "cmr77dvhg0018rx06z11d3k9z", "logo": "https://media.goal-api.com/badges/logo_leagues/17_conmebol-copa-america.png", "name": "CONMEBOL Copa America" }, "matchDate": "2024-07-11", "matchTime": "02:00" }, "fixtureId": "cmrjj80u8e79go807sktlxpz1", "id": "cmrmwyz5957llt007hr0ibf9l", "title": "Highlights", "titleFull": "Highlights", "updatedAt": "2026-07-16T02:52:48.610Z", "url": "https://www.g-video.tv/5529559.mp4" }, { "apiId": "1784170370303", "createdAt": "2026-07-16T02:52:46.207Z", "fixture": { "awayTeamName": "Canada", "awayTeamScore": "0", "homeTeamName": "Argentina", "homeTeamScore": "2", "id": "cmrjj9fhzhjvto807qtlioqrx", "league": { "id": "cmr77dvhg0018rx06z11d3k9z", "logo": "https://media.goal-api.com/badges/logo_leagues/17_conmebol-copa-america.png", "name": "CONMEBOL Copa America" }, "matchDate": "2024-07-10", "matchTime": "02:00" }, "fixtureId": "cmrjj9fhzhjvto807qtlioqrx", "id": "cmrmwyxag57lht0077j0g5a8e", "title": "Highlights", "titleFull": "Highlights", "updatedAt": "2026-07-16T02:52:46.198Z", "url": "https://www.g-video.tv/5527794.mp4" } ], "leagueId": "cmr77dvhg0018rx06z11d3k9z", "pagination": { "hasMore": true, "limit": 5, "offset": 0, "total": 12 }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getVideosLeagueByLeagueId" } }, "/videos/date/{date}": { "get": { "tags": [ "Videos" ], "summary": "Highlights on a date", "parameters": [ { "name": "date", "in": "path", "required": true, "schema": { "type": "string", "format": "date" } }, { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" } ], "responses": { "200": { "description": "Videos", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Video" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": [], "date": "2026-08-06", "pagination": { "hasMore": false, "limit": 5, "offset": 0, "total": 0 }, "source": "database", "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getVideosDateByDate" } }, "/odds": { "get": { "tags": [ "Odds" ], "summary": "List odds", "parameters": [ { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" }, { "name": "bookmaker", "in": "query", "schema": { "type": "string" } }, { "name": "matchId", "in": "query", "schema": { "type": "string" }, "description": "Provider match id" } ], "responses": { "200": { "description": "Odds", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Odd" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": [ { "asianHandicap": null, "bookmaker": "Dafabet", "btsNo": null, "btsYes": null, "createdAt": "2026-08-06T03:01:38.715Z", "fixtureId": "cmsg1gsg6d76iny07yr0tevo3", "id": "cmsgxj8635teiqd07g0n7x3nw", "matchApiId": "834690", "odd1": "2.29", "odd12": null, "odd1x": null, "odd2": "3.4", "oddDate": "2026-08-06 12:23:01", "oddX": "3.15", "oddX2": null, "overUnder": null, "updatedAt": "2026-08-06T12:02:57.576Z" }, { "asianHandicap": null, "bookmaker": "888Sport", "btsNo": "1.8", "btsYes": "1.95", "createdAt": "2026-08-06T00:03:01.316Z", "fixtureId": "cmsg1gsg6d76iny07yr0tevo3", "id": "cmsgr5ikjkpsuqd07a6umgw6p", "matchApiId": "834690", "odd1": "2.2", "odd12": "1.36", "odd1x": "1.3", "odd2": "3.4", "oddDate": "2026-08-06 12:23:01", "oddX": "2.9", "oddX2": "1.62", "overUnder": { "o+0.5": "1.08", "o+1.5": "1.4", "o+2.5": "2.3", "o+3.5": "4.4", "o+4.5": "9.5", "o+5.5": "23", "u+0.5": "7", "u+1.5": "2.7", "u+2.5": "1.57", "u+3.5": "1.18", "u+4.5": "1.06", "u+5.5": "1.01" }, "updatedAt": "2026-08-06T12:02:57.571Z" } ], "pagination": { "hasMore": true, "limit": 5, "offset": 0, "total": 54759 }, "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getOdds" } }, "/predictions": { "get": { "tags": [ "Predictions" ], "summary": "List predictions", "parameters": [ { "$ref": "#/components/parameters/limit" }, { "$ref": "#/components/parameters/offset" }, { "name": "matchId", "in": "query", "schema": { "type": "string" } }, { "name": "leagueName", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Predictions", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "const": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Prediction" } }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "source": { "type": "string", "enum": [ "cache", "database" ], "description": "Whether this response was served from cache or read from the database." } }, "required": [ "success", "data" ] }, "example": { "data": [ { "asianHandicap": { "prob_ah_a_-05": "15.00", "prob_ah_a_-15": "36.00", "prob_ah_a_-25": "59.00", "prob_ah_a_-35": "78.00", "prob_ah_a_-45": "90.00", "prob_ah_a_05": "4.00", "prob_ah_a_15": "1.00", "prob_ah_a_25": "0.00", "prob_ah_a_35": "0.00", "prob_ah_a_45": "0.00", "prob_ah_h_-05": "85.00", "prob_ah_h_-15": "64.00", "prob_ah_h_-25": "41.00", "prob_ah_h_-35": "22.00", "prob_ah_h_-45": "10.00", "prob_ah_h_05": "96.00", "prob_ah_h_15": "99.00", "prob_ah_h_25": "100.00", "prob_ah_h_35": "100.00", "prob_ah_h_45": "100.00" }, "countryName": null, "createdAt": "2026-08-06T06:30:16.173Z", "fixtureId": "cmsgr3whekbm4qd07kn9m0eh3", "id": "cmsh4zip9l6qkqd07mu3ro0hk", "leagueName": "Liga 3", "matchApiId": "727920", "matchDate": "2026-08-13", "matchStatus": "Not Started", "matchTime": "17:00", "probAW": "4.00", "probAWD": "15.00", "probBts": "29.00", "probD": "11.00", "probHW": "85.00", "probHWAW": "89.00", "probHWD": "96.00", "probO": "57.00", "probO1": "80.00", "probO3": "35.00", "probOts": "71.00", "probU": "43.00", "probU1": "20.00", "probU3": "65.00", "updatedAt": "2026-08-06T06:30:16.173Z" }, { "asianHandicap": { "prob_ah_a_-05": "12.00", "prob_ah_a_-15": "30.00", "prob_ah_a_-25": "52.00", "prob_ah_a_-35": "72.00", "prob_ah_a_-45": "86.00", "prob_ah_a_05": "3.00", "prob_ah_a_15": "0.00", "prob_ah_a_25": "0.00", "prob_ah_a_35": "0.00", "prob_ah_a_45": "0.00", "prob_ah_h_-05": "88.00", "prob_ah_h_-15": "70.00", "prob_ah_h_-25": "48.00", "prob_ah_h_-35": "28.00", "prob_ah_h_-45": "14.00", "prob_ah_h_05": "97.00", "prob_ah_h_15": "100.00", "prob_ah_h_25": "100.00", "prob_ah_h_35": "100.00", "prob_ah_h_45": "100.00" }, "countryName": null, "createdAt": "2026-08-06T06:30:15.937Z", "fixtureId": "cmsgr3vvfkbhgqd071kscjg60", "id": "cmsh4zin5l6qhqd07hsjzzwr1", "leagueName": "Liga 3", "matchApiId": "727919", "matchDate": "2026-08-13", "matchStatus": "Not Started", "matchTime": "15:00", "probAW": "3.00", "probAWD": "12.00", "probBts": "30.00", "probD": "9.00", "probHW": "88.00", "probHWAW": "91.00", "probHWD": "97.00", "probO": "64.00", "probO1": "84.00", "probO3": "42.00", "probOts": "70.00", "probU": "36.00", "probU1": "16.00", "probU3": "58.00", "updatedAt": "2026-08-06T06:30:15.937Z" } ], "pagination": { "hasMore": true, "limit": 5, "offset": 0, "total": 2844 }, "success": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "operationId": "getPredictions" } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "description": "Your API key, sent as `Authorization: Bearer `. Create one from the dashboard." } }, "parameters": { "limit": { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50 }, "description": "Results per page" }, "offset": { "name": "offset", "in": "query", "schema": { "type": "integer", "minimum": 0, "default": 0 }, "description": "Results to skip" }, "search": { "name": "search", "in": "query", "schema": { "type": "string" }, "description": "Case-insensitive name filter" }, "season": { "name": "season", "in": "query", "schema": { "type": "string" }, "description": "Season, e.g. 2025/2026" }, "isActive": { "name": "isActive", "in": "query", "schema": { "type": "boolean" }, "description": "Filter by active status" } }, "responses": { "BadRequest": { "description": "Invalid parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "code": "VALIDATION_ERROR", "details": [ { "location": "params", "msg": "Invalid stat parameter", "path": "stat", "type": "field", "value": "not-a-stat" } ], "error": "Validation failed", "success": false } } } }, "Unauthorized": { "description": "Missing or invalid API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "category": "authentication", "code": "INVALID_API_KEY", "correlationId": "gw-1786019861982-x8fwhq2", "details": null, "message": "Invalid API key", "success": false, "timestamp": "2026-08-06T12:37:42.019Z" } } } }, "Forbidden": { "description": "Your plan does not include this data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "NotFound": { "description": "No such resource", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "code": "FIXTURE_NOT_FOUND", "error": "Fixture not found", "success": false } } } }, "RateLimited": { "description": "Request quota exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "schemas": { "Error": { "type": "object", "properties": { "success": { "type": "boolean", "const": false }, "error": { "type": "string" }, "message": { "type": "string" }, "code": { "type": "string", "examples": [ "MISSING_AUTHENTICATION", "PLAN_CAPABILITY_DENIED", "FIXTURE_NOT_FOUND" ] }, "category": { "type": "string" }, "details": { "description": "Error-specific context. An object on gateway errors, an array of field failures on validation errors." }, "correlationId": { "type": "string", "description": "Quote this when contacting support" }, "timestamp": { "type": "string", "format": "date-time" } }, "required": [ "success" ] }, "Pagination": { "type": "object", "properties": { "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" }, "hasMore": { "type": "boolean" } } }, "MatchStatus": { "type": "string", "enum": [ "SCHEDULED", "LIVE", "FINISHED", "HALF_TIME", "AFTER_ET", "AFTER_PEN", "POSTPONED", "CANCELLED", "AWARDED", "ABANDONED", "SUSPENDED" ] }, "PlayerPosition": { "type": "string", "enum": [ "Goalkeepers", "Defenders", "Midfielders", "Forwards" ] }, "PlayerStat": { "type": "string", "enum": [ "goals", "assists", "yellowCards", "redCards", "rating", "matchPlayed", "minutes", "saves", "tackles", "shotsTotal", "keyPasses", "passes", "interceptions", "duelsWon", "dribbleSucc" ] }, "Country": { "type": "object", "properties": { "id": { "type": "string" }, "apiId": { "type": "string" }, "name": { "type": "string" }, "logo": { "type": [ "string", "null" ] }, "isActive": { "type": "boolean" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } } }, "League": { "type": "object", "properties": { "id": { "type": "string" }, "apiId": { "type": "string" }, "name": { "type": "string" }, "countryId": { "type": [ "string", "null" ] }, "countryName": { "type": [ "string", "null" ] }, "season": { "type": [ "string", "null" ] }, "logo": { "type": [ "string", "null" ] }, "isActive": { "type": "boolean" }, "popularity": { "type": "integer", "description": "Editorial prominence, higher first. Drives default ordering." } } }, "Team": { "type": "object", "properties": { "id": { "type": "string" }, "apiId": { "type": "string" }, "name": { "type": "string" }, "country": { "type": [ "string", "null" ] }, "founded": { "type": [ "string", "null" ] }, "badge": { "type": [ "string", "null" ] }, "isActive": { "type": "boolean" }, "venueName": { "type": [ "string", "null" ] }, "venueCity": { "type": [ "string", "null" ] }, "venueCapacity": { "type": [ "string", "null" ] }, "venueSurface": { "type": [ "string", "null" ] } } }, "Fixture": { "type": "object", "description": "A match. Scores are strings because the upstream provider sends them as text, and are null before kick-off.", "properties": { "id": { "type": "string" }, "apiId": { "type": "string", "description": "Provider match id" }, "countryName": { "type": [ "string", "null" ] }, "countryLogo": { "type": [ "string", "null" ] }, "leagueId": { "type": [ "string", "null" ] }, "leagueName": { "type": [ "string", "null" ] }, "leagueLogo": { "type": [ "string", "null" ] }, "matchDate": { "type": [ "string", "null" ], "format": "date" }, "matchTime": { "type": [ "string", "null" ] }, "matchStatus": { "$ref": "#/components/schemas/MatchStatus" }, "homeTeamId": { "type": [ "string", "null" ] }, "homeTeamName": { "type": [ "string", "null" ] }, "homeTeamScore": { "type": [ "string", "null" ] }, "homeTeamBadge": { "type": [ "string", "null" ] }, "awayTeamId": { "type": [ "string", "null" ] }, "awayTeamName": { "type": [ "string", "null" ] }, "awayTeamScore": { "type": [ "string", "null" ] }, "awayTeamBadge": { "type": [ "string", "null" ] }, "homeTeamHalftimeScore": { "type": [ "string", "null" ] }, "awayTeamHalftimeScore": { "type": [ "string", "null" ] }, "homeTeamSystem": { "type": [ "string", "null" ], "description": "Formation, e.g. 4-2-3-1. Present on ~16% of fixtures." }, "awayTeamSystem": { "type": [ "string", "null" ] }, "matchRound": { "type": [ "string", "null" ] }, "matchStadium": { "type": [ "string", "null" ] }, "matchReferee": { "type": [ "string", "null" ] } } }, "MatchEvent": { "type": "object", "description": "One timeline entry. The scorer is split across homeScorer/awayScorer, which is also how you know the side.", "properties": { "time": { "type": [ "string", "null" ] }, "type": { "type": [ "string", "null" ] }, "score": { "type": [ "string", "null" ] }, "homeScorer": { "type": [ "string", "null" ] }, "awayScorer": { "type": [ "string", "null" ] }, "homeAssist": { "type": [ "string", "null" ] }, "awayAssist": { "type": [ "string", "null" ] }, "info": { "type": [ "string", "null" ] } } }, "LineupEntry": { "type": "object", "properties": { "lineupPlayer": { "type": [ "string", "null" ] }, "lineupNumber": { "type": [ "string", "null" ], "description": "Shirt number" }, "lineupPosition": { "type": [ "string", "null" ], "description": "Ordinal, 1 is the goalkeeper. Stored as text." }, "playerId": { "type": [ "string", "null" ], "description": "Resolved player id, present when we recognise the player" }, "playerImage": { "type": [ "string", "null" ] }, "playerPosition": { "$ref": "#/components/schemas/PlayerPosition" } } }, "LineupSide": { "type": "object", "properties": { "startingLineups": { "type": "array", "items": { "$ref": "#/components/schemas/LineupEntry" } }, "substitutes": { "type": "array", "items": { "$ref": "#/components/schemas/LineupEntry" } }, "coach": { "type": "array", "items": { "$ref": "#/components/schemas/LineupEntry" } }, "missingPlayers": { "type": "array", "items": { "$ref": "#/components/schemas/LineupEntry" } } } }, "Lineups": { "type": "object", "properties": { "home": { "$ref": "#/components/schemas/LineupSide" }, "away": { "$ref": "#/components/schemas/LineupSide" }, "homeFormation": { "type": [ "string", "null" ] }, "awayFormation": { "type": [ "string", "null" ] }, "hasLineups": { "type": "boolean" } } }, "MatchStatistics": { "type": "object", "properties": { "match": { "type": "object", "properties": { "fullTime": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "home": { "type": "string" }, "away": { "type": "string" } } } } } } } }, "ResultsStats": { "type": "object", "description": "Aggregates over the most recent 1,000 completed matches in the filtered set — NOT the whole dataset. `totalMatches` is how many were actually counted, so it reads 1000 whenever the filter matches at least that many; narrow with `leagueId` and a date range to describe a specific population. Counts are integers, averages carry two decimals, and percentages are whole numbers.", "properties": { "totalMatches": { "type": "integer", "description": "Matches counted, capped at 1000" }, "totalGoals": { "type": "integer" }, "averageGoals": { "type": "number" }, "averageHomeGoals": { "type": "number" }, "averageAwayGoals": { "type": "number" }, "homeWins": { "type": "integer" }, "awayWins": { "type": "integer" }, "draws": { "type": "integer" }, "homeWinPercentage": { "type": "integer" }, "awayWinPercentage": { "type": "integer" }, "drawPercentage": { "type": "integer" }, "bttsCount": { "type": "integer", "description": "Matches in which both teams scored" }, "bttsPercentage": { "type": "integer" }, "over25Count": { "type": "integer", "description": "Matches with strictly more than 2.5 goals" }, "over25Percentage": { "type": "integer" }, "over35Count": { "type": "integer", "description": "Matches with strictly more than 3.5 goals" }, "over35Percentage": { "type": "integer" }, "cleanSheets": { "type": "object", "description": "Matches in which that side conceded nothing.", "properties": { "home": { "type": "integer" }, "away": { "type": "integer" } } }, "mostGoalsInMatch": { "type": "integer" }, "highestScoringMatch": { "type": [ "object", "null" ], "description": "Null when nothing matched the filter.", "properties": { "id": { "type": "string" }, "date": { "type": "string", "format": "date" }, "homeTeam": { "type": "string" }, "awayTeam": { "type": "string" }, "score": { "type": "string", "description": "Final score as \"home-away\"" } } }, "mostCommonScore": { "type": [ "object", "null" ], "properties": { "score": { "type": "string" }, "count": { "type": "integer" }, "percentage": { "type": "integer" } } }, "scoreDistribution": { "type": "object", "additionalProperties": { "type": "integer" }, "description": "Match count keyed by final score, e.g. { \"2-1\": 78 }. Keys are home-away and unbounded — a 16-1 appears if one was played." } } }, "Standing": { "type": "object", "description": "A table row. Numeric fields are strings, as the provider sends them.\n\nEvery row carries the home-only and away-only splits alongside the overall figures, but the provider publishes them for some competitions and not others: expect `homeLeague*` and `awayLeague*` to be null on plenty of tables, and check before relying on them. `/standings/{leagueId}/home` and `/away` sort and renumber by exactly these fields, and 404 for a competition that lacks them.", "properties": { "teamId": { "type": [ "string", "null" ] }, "teamName": { "type": [ "string", "null" ] }, "leagueRound": { "type": [ "string", "null" ] }, "stageName": { "type": [ "string", "null" ] }, "overallLeaguePosition": { "type": [ "string", "null" ] }, "overallLeaguePlayed": { "type": [ "string", "null" ] }, "overallLeagueW": { "type": [ "string", "null" ] }, "overallLeagueD": { "type": [ "string", "null" ] }, "overallLeagueL": { "type": [ "string", "null" ] }, "overallLeagueGF": { "type": [ "string", "null" ] }, "overallLeagueGA": { "type": [ "string", "null" ] }, "overallLeaguePTS": { "type": [ "string", "null" ] }, "overallPromotion": { "type": [ "string", "null" ] }, "homeLeaguePosition": { "type": [ "string", "null" ], "description": "Position in the home-only table" }, "homeLeaguePlayed": { "type": [ "string", "null" ] }, "homeLeagueW": { "type": [ "string", "null" ] }, "homeLeagueD": { "type": [ "string", "null" ] }, "homeLeagueL": { "type": [ "string", "null" ] }, "homeLeagueGF": { "type": [ "string", "null" ] }, "homeLeagueGA": { "type": [ "string", "null" ] }, "homeLeaguePTS": { "type": [ "string", "null" ] }, "homePromotion": { "type": [ "string", "null" ] }, "awayLeaguePosition": { "type": [ "string", "null" ], "description": "Position in the away-only table" }, "awayLeaguePlayed": { "type": [ "string", "null" ] }, "awayLeagueW": { "type": [ "string", "null" ] }, "awayLeagueD": { "type": [ "string", "null" ] }, "awayLeagueL": { "type": [ "string", "null" ] }, "awayLeagueGF": { "type": [ "string", "null" ] }, "awayLeagueGA": { "type": [ "string", "null" ] }, "awayLeaguePTS": { "type": [ "string", "null" ] }, "awayPromotion": { "type": [ "string", "null" ] } } }, "SplitStanding": { "description": "A row from the home-only or away-only table. It is an ordinary Standing — the overall* and both sets of split fields are all still there — plus NUMERIC position/played/wins/… overrides computed for the side you asked for. Read those, not overall*, or a home table will report the combined record.", "allOf": [ { "$ref": "#/components/schemas/Standing" }, { "type": "object", "properties": { "position": { "type": "integer" }, "played": { "type": "integer" }, "wins": { "type": "integer" }, "draws": { "type": "integer" }, "losses": { "type": "integer" }, "goalsFor": { "type": "integer" }, "goalsAgainst": { "type": "integer" }, "points": { "type": "integer" } } } ] }, "StandingZones": { "type": "object", "properties": { "leagueId": { "type": "string" }, "zones": { "type": "object", "properties": { "promotion": { "type": "array", "items": { "$ref": "#/components/schemas/Standing" } }, "europeanQualification": { "type": "array", "items": { "$ref": "#/components/schemas/Standing" } }, "safe": { "type": "array", "items": { "$ref": "#/components/schemas/Standing" } }, "relegation": { "type": "array", "items": { "$ref": "#/components/schemas/Standing" } } } } } }, "Player": { "type": "object", "properties": { "id": { "type": "string" }, "apiId": { "type": "string" }, "name": { "type": "string" }, "image": { "type": [ "string", "null" ] }, "number": { "type": [ "string", "null" ] }, "country": { "type": [ "string", "null" ] }, "type": { "$ref": "#/components/schemas/PlayerPosition" }, "age": { "type": [ "string", "null" ] }, "birthdate": { "type": [ "string", "null" ] }, "teamId": { "type": [ "string", "null" ] }, "injured": { "type": [ "string", "null" ] }, "matchPlayed": { "type": [ "string", "null" ] }, "goals": { "type": [ "string", "null" ] }, "assists": { "type": [ "string", "null" ] }, "yellowCards": { "type": [ "string", "null" ] }, "redCards": { "type": [ "string", "null" ] }, "rating": { "type": [ "string", "null" ] } } }, "TopPlayer": { "type": "object", "description": "Ranked player. The requested stat appears as its own key, e.g. `goals`.", "properties": { "rank": { "type": "integer" }, "id": { "type": "string" }, "name": { "type": "string" }, "team": { "type": "string" }, "teamBadge": { "type": [ "string", "null" ] }, "position": { "type": "string" }, "image": { "type": [ "string", "null" ] }, "matchPlayed": { "type": "integer" } } }, "TopScorer": { "type": "object", "properties": { "playerPlace": { "type": [ "string", "null" ] }, "playerName": { "type": [ "string", "null" ] }, "teamName": { "type": [ "string", "null" ] }, "goals": { "type": [ "string", "null" ] }, "assists": { "type": [ "string", "null" ] }, "penaltyGoals": { "type": [ "string", "null" ] } } }, "Coach": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": [ "string", "null" ] }, "country": { "type": [ "string", "null" ] }, "teamId": { "type": [ "string", "null" ] } } }, "TeamStatistics": { "type": "object", "description": "Aggregate team statistics for the current season.", "additionalProperties": true }, "HeadToHead": { "type": "object", "description": "Match lists here use the PROVIDER's raw field names (match_hometeam_name, match_status as free text), not the Fixture shape.", "properties": { "team1Id": { "type": "string" }, "team1Name": { "type": "string" }, "team2Id": { "type": "string" }, "team2Name": { "type": "string" }, "directMatches": { "type": "array", "items": { "$ref": "#/components/schemas/ProviderMatch" } }, "team1Recent": { "type": "array", "items": { "$ref": "#/components/schemas/ProviderMatch" } }, "team2Recent": { "type": "array", "items": { "$ref": "#/components/schemas/ProviderMatch" } } } }, "ProviderMatch": { "type": "object", "description": "A match in the upstream provider's raw shape, returned only by head-to-head.", "properties": { "match_id": { "type": "string" }, "match_date": { "type": "string" }, "match_time": { "type": "string" }, "match_status": { "type": "string", "description": "Free text such as 'Finished', not the MatchStatus enum" }, "match_hometeam_name": { "type": "string" }, "match_awayteam_name": { "type": "string" }, "match_hometeam_score": { "type": "string" }, "match_awayteam_score": { "type": "string" }, "team_home_badge": { "type": "string" }, "team_away_badge": { "type": "string" }, "league_name": { "type": "string" }, "league_logo": { "type": "string" } } }, "Video": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": [ "string", "null" ] }, "titleFull": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ] }, "fixtureId": { "type": [ "string", "null" ] }, "createdAt": { "type": "string", "format": "date-time" } } }, "Odd": { "type": "object", "description": "One bookmaker's prices. asianHandicap and overUnder are objects keyed by line, because bookmakers publish different lines per match.", "properties": { "id": { "type": "string" }, "matchApiId": { "type": "string" }, "fixtureId": { "type": [ "string", "null" ] }, "bookmaker": { "type": [ "string", "null" ] }, "oddDate": { "type": [ "string", "null" ] }, "odd1": { "type": [ "string", "null" ] }, "oddX": { "type": [ "string", "null" ] }, "odd2": { "type": [ "string", "null" ] }, "odd1x": { "type": [ "string", "null" ] }, "odd12": { "type": [ "string", "null" ] }, "oddX2": { "type": [ "string", "null" ] }, "btsYes": { "type": [ "string", "null" ] }, "btsNo": { "type": [ "string", "null" ] }, "asianHandicap": { "type": [ "object", "null" ], "additionalProperties": { "type": "string" }, "description": "Keyed by line, e.g. \"ah-1_1\"" }, "overUnder": { "type": [ "object", "null" ], "additionalProperties": { "type": "string" }, "description": "Keyed by line, e.g. \"o+2.5\"" } } }, "LiveOdd": { "type": "object", "properties": { "id": { "type": "string" }, "matchApiId": { "type": "string" }, "fixtureId": { "type": [ "string", "null" ] }, "oddName": { "type": "string" }, "type": { "type": "string" }, "value": { "type": [ "string", "null" ] }, "handicap": { "type": [ "string", "null" ] }, "suspended": { "type": [ "string", "null" ] }, "providerUpdatedAt": { "type": [ "string", "null" ] } } }, "Prediction": { "type": "object", "description": "Outcome probabilities as decimal strings between 0.00 and 1.00.", "properties": { "id": { "type": "string" }, "matchApiId": { "type": "string" }, "fixtureId": { "type": [ "string", "null" ] }, "leagueName": { "type": [ "string", "null" ] }, "matchDate": { "type": [ "string", "null" ] }, "matchTime": { "type": [ "string", "null" ] }, "probHW": { "type": [ "string", "null" ], "description": "Home win" }, "probD": { "type": [ "string", "null" ], "description": "Draw" }, "probAW": { "type": [ "string", "null" ], "description": "Away win" }, "probHWD": { "type": [ "string", "null" ], "description": "Home win or draw" }, "probAWD": { "type": [ "string", "null" ], "description": "Away win or draw" }, "probBts": { "type": [ "string", "null" ], "description": "Both teams to score" }, "asianHandicap": { "type": [ "object", "null" ], "additionalProperties": { "type": "string" } } } }, "Commentary": { "type": "object", "properties": { "id": { "type": "string" }, "matchApiId": { "type": "string" }, "fixtureId": { "type": [ "string", "null" ] }, "time": { "type": "string", "description": "mm:ss from the provider, not a minute number" }, "text": { "type": "string" }, "state": { "type": [ "string", "null" ] } } } } } }