{ "openapi": "3.0.0", "info": { "version": "1.0", "title": "LiveScore API", "description": "LiveScore API for real-time sports scores, live scores, livescores, fixtures, results, standings, statistics, scores and match data. Sports API covering football, soccer, basketball, cricket, tennis, hockey and more. Build live score apps, sports websites, scoreboards and sports data platforms similar to Sofascore, Flashscore, LiveScore, FotMob, AiScore, ESPN and Soccerway.", "x-category": "Data", "x-long-description": "# ⚽ LiveScore API\n\nBring live sports scores, fixtures, results, standings and match context into your application with LiveScore data. Follow football and soccer, basketball, cricket, tennis, ice hockey and American football, then add team profiles, player records, statistics and sports content where coverage is available.\n\n| Feature | Details |\n| --- | --- |\n| **Last Updated** | **October 5, 2026** |\n| 🏟️ Sports Coverage | Football and soccer, basketball, cricket, tennis, ice hockey and American football; horse-racing discovery |\n| 📅 Fixtures and Results | Dated and live boards, competition schedules, team fixture sets and selected upcoming or finished views |\n| ⏱️ Match Scores and State | Scores, periods, sets, innings, kickoff times and available match clocks |\n| 🧩 Match Context | Lineups, substitutions, incidents, commentary, head-to-head history, form, venue references and officials |\n| 🏆 Competition Data | Competition and stage discovery, standings, knockout brackets and player or team leaderboards |\n| 👥 Teams and Players | Team identity, squads, stage addresses, fixture windows, athlete profiles, match logs and season figures |\n| 🏏 Cricket Scorecards | Batting and bowling figures, wicket falls, innings and over-by-over details where published |\n| 📰 Sports Content | News, article summaries, video playlists, social posts, television listings, community picks and topics |\n| 🌍 Localization and Date Views | Available localized fields and interface strings; UTC offsets for date-addressed requests |\n| ⚡ API Type | Fast REST API via RapidAPI |\n\n## Overview\n\nThe LiveScore API is an unofficial sports data API for live score apps, sports websites, competition pages and match dashboards. Discover a fixture or entity, retain its identifier, and request the scores, statistics, profiles or content your product needs through focused endpoints.\n\nUse it for scoreboard experiences, followed-team views, tournament tracking, match previews, sports editorial pages and player research. Data availability depends on sport, competition, fixture, season and archive date. Optional datasets can be null or empty even when the fixture itself is available. Horse racing is a discovery capability rather than a live or dated fixture-board feed.\n\n## Key Features\n\n- Discover sports, teams, players, countries, competitions and stage addresses.\n- Browse live fixtures and date-based boards with applicable filters and pagination.\n- Follow fixture scores, state and available clocks across supported sports.\n- Add lineups, substitutions, incidents, commentary, form and head-to-head context.\n- Display standings, cup brackets and ranked player or team statistics.\n- Build team and athlete pages from identity, squad, fixture and season data.\n- Present cricket scorecards with innings, batting, bowling and wicket details.\n- Add sports news, video, social content, television listings and authored community picks where published.\n- Resolve known identifiers in batches within one entity family.\n\n## Available Data\n\nSport identifiers; country and competition identities; stage and season addresses; fixture IDs, teams, kickoff times, scores and state; applicable sets, periods and innings; team badges and kits; venue references, venue details and officials; formations, players and substitutions; match statistics, shot maps and timelines; standings, rankings and knockout ties; athlete profiles and season figures; news summaries, article IDs, videos, social posts, broadcast channels, community picks and topic references.\n\nCounts describe the scope documented by each endpoint. A missing measurement is not zero, a shortlist is not a complete directory, and a bounded fixture window is not a complete season. Editorial and media coverage can be selective. Dates use the documented calendar format; timestamps and offsets retain their endpoint-specific meanings.\n\n## Discovery\n\n### `/sports`\n\nDiscover sport names, identifiers and their ordering for a selected country. Use the returned sport vocabulary to address fixtures and other sport-specific data. Horse racing is available through discovery; its coverage does not include the dated or live fixture boards.\n\n### `/timezones`\n\nRead supported UTC offset examples for date-based requests, including fractional offsets. Choose the offset in effect on the requested date; daylight saving is not applied automatically. This is an offset reference rather than a named-timezone database.\n\n### `/table-legend`\n\nRead standings-zone labels, colors and footnote references. Use the legend to explain qualification, relegation and other published table markers alongside competition or team standings.\n\n### `/translations`\n\nGet the interface string table for a required locale. Use it for available labels and display vocabulary; it is not a translation service for arbitrary text, and translated content varies by dataset.\n\n### `/search`\n\nFind teams, players, competitions or countries by name, selecting one entity kind per request. Use queries of at least three characters to discover IDs for follow-up calls. Search defaults to teams and supports an explicit result limit.\n\n### `/popular`\n\nRead a curated shortlist for one selected entity kind. Use it for suggested teams, players, competitions or countries in navigation and selection screens. The shortlist is not a complete directory.\n\n### `/competitions`\n\nDiscover the competitions and stages with coverage on a calendar date, grouped by country. Pair the date with sport and the desired UTC offset, then retain competition IDs and stage IDs separately for the matching follow-up endpoints.\n\n### `/resolve`\n\nResolve up to 50 IDs from exactly one family: teams, players, competitions or stages. Supply a comma-separated list for that family. Use this to populate known selections with identity data; athlete IDs and squad registration IDs are different addresses.\n\n## Fixtures\n\n### `/matches-by-date`\n\nBrowse a date-addressed fixture board by sport, with competition, team, country or league selection and upcoming or finished views. Filters apply before pagination. Use page counts and paging fields to walk matching fixtures; full-board counts describe a different scope.\n\n### `/live-matches`\n\nRead fixtures currently in play, grouped by competition, for a selected sport. Narrow by team or competition and page through the matching board. A quiet period can return an empty result, and successive pages can change as fixtures progress.\n\n### `/matches-by-competition`\n\nRead the fixtures published for a competition ID, with scores, state and times where available. Use it for competition fixture and result screens. Obtain the ID from competition discovery and retain the season or stage context supplied with the fixtures.\n\n### `/league-matches`\n\nRead a competition schedule using its published country and league slugs, paired with sport. Use it when your navigation already uses league names in URL form. Slugs are discovery values rather than names to guess or numeric IDs to substitute.\n\n### `/matches-by-team`\n\nRead fixtures for up to 50 team IDs in one sport, grouped by competition. Use a comma-separated team list to build followed-team views and shared fixture collections without treating team names as addresses.\n\n### `/match-updates`\n\nRead a sample of recently changing soccer fixtures, with compact score and state patches. Use the returned cursor with `since` for subsequent checks and keep full fixture details separately. This is not a complete event history or a guaranteed stream of every change.\n\n### `/day-coverage`\n\nRead the match, stage, competition and participant IDs covered on a date for a selected sport and UTC offset. Use it to discover the available fixture addresses and compare date coverage; it does not replace the detailed fixture board.\n\n## Match\n\n### `/match-details`\n\nRead one fixture's teams, score, state, clocks and competition context. Score variants include applicable sets, periods or cricket innings. The shallow venue reference retains its ID and artwork; combine it with `/match-info` for detailed venue fields using the same match ID and sport.\n\n### `/match-statistics`\n\nRead team statistics, period splits and shot locations where the fixture has coverage. Use it for comparison panels and match analysis. Available measures and maps depend on sport and fixture; missing statistics are not recorded zero values.\n\n### `/match-lineups`\n\nRead formations, starters, substitutes, coaches, unavailable players and recorded substitutions. Match the published side number to the home or away team on `/match-details` when team identity is absent. Use `/match-key-players` separately for highlighted players and figures.\n\n### `/match-incidents`\n\nRead the recorded fixture timeline, including goals, cards and other published events with time, participants and score context. Use it for an event feed. Recorded substitutions belong to `/match-lineups`; timeline coverage varies by sport and fixture.\n\n### `/match-commentary`\n\nRead the written commentary published for a fixture. Use it for text updates and match narrative alongside the scoreboard or incident timeline. Commentary can be empty when the fixture has no written coverage.\n\n### `/match-media`\n\nRead fixture highlight and clip playlists with published titles, artwork and video links. Use it for media panels. Video availability varies by fixture; social posts are available separately through `/match-social-posts`.\n\n### `/match-h2h`\n\nRead the head-to-head record for the sides of a fixture, including available historical meetings and summaries. Use it for preview and comparison screens. History is coverage-dependent and does not promise a complete archive of all meetings.\n\n### `/match-form`\n\nRead recent results for both sides of a fixture, with an optional history limit. Use it for pre-match form strips and recent-performance comparisons. Retain the published result and fixture context instead of inferring a result from missing scores.\n\n### `/match-standings`\n\nRead the standings rows published for the sides of a fixture. Use it to show their table positions next to a match. For the full competition table, use `/standings` or `/league-table`; a fixture may have no applicable standings.\n\n### `/match-insights`\n\nRead available editorial statistical talking points for a fixture. Use them for match previews or contextual panels. Coverage is selective, and an empty list is valid; written verdicts have their own endpoint.\n\n### `/match-innings`\n\nRead a cricket fixture's innings scorecards, batting and bowling figures, wicket falls and over-by-over details where published. Address it with a cricket match ID and `sport=cricket`. Overs use cricket ball notation, so 14.5 means 14 overs and five balls.\n\n### `/match-info`\n\nRead detailed venue information, including city, country, capacity and neutral-ground status, together with officials and the information-specific kickoff time. Venue ID or artwork can be missing here; use non-null reference fields from `/match-details` for the same fixture and sport.\n\n### `/match-key-players`\n\nRead the highlighted players and their available figures for each side. Use team IDs or side numbers to join these players to the fixture. These are selected highlights rather than the full lineup sheet, and some figures have no published label.\n\n### `/match-verdict`\n\nRead a fixture's written editorial verdict and selected outcome where available. Use it as authored preview content. Coverage is selective and can be empty; it is separate from statistical talking points and community picks.\n\n### `/match-social-posts`\n\nRead social posts associated with a fixture, including authors, text, artwork and public links where available. Use it for a match discussion or social panel. An empty timeline is valid, and a published total can exceed the returned collection.\n\n## Competition\n\n### `/competition-details`\n\nRead a league, cup or tournament's identity and published stage structure. Use it to discover season or phase addresses and retain the distinction between competition IDs and stage IDs before requesting statistics or fixtures.\n\n### `/standings`\n\nRead a competition's full published standings, including groups, positions, points and qualification or form markers where available. Use `/table-legend` to interpret table annotations. League, cup and tournament table coverage can differ.\n\n### `/competition-player-stats`\n\nRead ranked player statistics for a competition with available player and team identities. Use `stat_group` for a dedicated measure or inspect the default tab overview. The overview is a preview, and explicit limits apply to selected statistic groups.\n\n### `/competition-team-stats`\n\nRead ranked team statistics for a competition with readable metrics and team identities. Request a named statistic group for a dedicated board, or browse the available overview tabs. A preview can contain empty categories; explicit limits concern selected groups rather than the overview.\n\n### `/league-table`\n\nRead full standings using a published country slug and league slug, paired with sport. Use it for league pages addressed by slugs. It offers the table rather than just the two standings rows associated with one fixture.\n\n### `/country-competitions`\n\nRead the competitions published for a known country or category slug and sport without specifying a date. Use it for country navigation after discovery. This lookup is not a complete query-less directory of every country and competition.\n\n### `/competition-draw`\n\nRead a cup's knockout bracket, rounds and ties using its competition ID. Use it for tournament progression views and multi-leg tie context where available. An ordinary league is not a cup bracket and can return no applicable draw.\n\n### `/competition-media`\n\nRead video playlists associated with a competition, including available titles, artwork and public links. Use it for league and tournament media sections. Coverage varies and can be empty.\n\n## Team\n\n### `/team-details`\n\nRead a club or national side's identity, badge, colors and workflow addresses. Use the returned competition, statistics and content references for focused follow-up calls. Competition listings and fixture windows are separate datasets rather than embedded collections.\n\n### `/team-squad`\n\nRead a team's registered players with available identity, shirt, position and profile fields. Use `player_id` for athlete profile, match and statistics requests. The separate `squad_player_id` identifies a registration and must not be substituted for the athlete ID.\n\n### `/team-matches`\n\nRead a team's next published fixture and recent form, with an optional result limit. Use it for a team summary or next-match card. It is a focused view rather than a complete season schedule.\n\n### `/team-standings`\n\nRead the table containing a team, with short or full table depth. Use it to show nearby positions or broader table context on a team page. Read full competition standings separately when your workflow needs that competition address.\n\n### `/team-stats`\n\nRead season statistics for a team in one competition or stage. Supply the matching competition or stage ID and use explicit `scope` when both are present. Use this for the club's figures; ranked player measures belong to `/team-player-stats`.\n\n### `/team-player-stats`\n\nRead player leaders within a team for one competition or stage, selecting an available named metric. Pair the scope with the correct ID and retain athlete IDs from the rows for profile requests. Coverage depends on the addressed season or phase.\n\n### `/team-media`\n\nRead club video playlists with available titles, thumbnails and public links. Use it for team media pages alongside the separate identity and fixture endpoints. A club can have no published videos.\n\n### `/team-competitions`\n\nRead the shallow competition and stage identities published for a team. Use them to choose the competition or phase for fixtures and statistics. The directory supplies addresses and names rather than a bundled schedule.\n\n### `/team-fixtures`\n\nRead nearest recent and upcoming fixtures for a team, with optional competition and stage selection. Each stage has up to ten fixtures in each direction; several stages can share one competition ID. Use these bounded windows for team pages rather than assuming a complete season schedule.\n\n## Player\n\n### `/player-details`\n\nRead an athlete's profile, current club, available career history and season addresses. Use the published season ID together with its team ID when requesting individual season statistics. Athlete profile IDs are different from squad registration IDs.\n\n### `/player-matches`\n\nRead the player's published match log grouped by competition-stage, with available contributions and involvement. Records can include fixtures where the player was named but did not play. Minutes display values can be text, so retain the published value instead of assuming every record contains numeric minutes.\n\n### `/player-stats`\n\nRead an athlete's figures for one season and team using the required player, season and team IDs. Obtain season addresses from `/player-details`; a numeric competition ID is not a season ID. Figures or ranks can be absent, and an empty result does not validate the identity.\n\n## Content\n\n### `/news`\n\nRead curated sports news or a scoped feed for a team, competition or country. Use a numeric ID with its entity kind, or a prefixed feed ID. Limit and offset apply to scoped news; the curated feed does not accept explicit pagination.\n\n### `/article`\n\nRead an article by its published article ID, including composite feed-and-article IDs where supplied. The requested article and summary appear first, followed by shallow neighboring suggestions. Use IDs from news feeds; this is not a lookup by an arbitrary public article slug.\n\n### `/tv-guide`\n\nRead broadcast listings for a country, including channel names and available fixture context. Use it for television guide screens with the documented pagination controls. Availability varies by country and time, and a listing does not establish viewing rights for every audience.\n\n### `/bet-tips`\n\nRead authored community picks and trending selections for a selected sport. Picks retain their topic associations. Use them as community content; they do not represent current sportsbook offers or a complete betting-odds feed.\n\n### `/tipster-topics`\n\nRead the topic catalog for community picks, with topic IDs, names and available post counts. Use it to label and organize the topics returned with picks. The catalog is separate from the picks themselves.\n\n## Common Use Cases\n\n- Build multi-sport live score apps and scoreboards.\n- Show daily fixtures and results with local date views.\n- Create competition pages with schedules, standings, leaders and cup brackets.\n- Assemble match pages with scores, lineups, incidents, statistics and previews.\n- Build followed-team views, squad pages and athlete season profiles.\n- Present cricket scorecards and innings comparisons.\n- Add sports editorial content, video panels and country-specific television guides.\n\n## Built for Developers\n\nBusiness endpoints use GET requests with query parameters. Start with `/sports`, `/search`, `/popular` or `/competitions` to discover valid addresses, then request the focused datasets your workflow needs. Keep fixture IDs paired with sport, competition IDs distinct from stage IDs, and athlete IDs distinct from squad registration IDs. Use the published season and team pair for player statistics.\n\nThe endpoint reference includes accepted controls, validation rules, response examples and null or empty-result guidance. Success responses carry `success: true` and `data`; failures carry `success: false` and a message. Paginated boards distinguish matching totals from returned rows. Available localization does not promise a translation of every name or authored article.\n\n## Why Use This API?\n\n- Combine multiple sports through a shared discovery and fixture workflow.\n- Request scores, identity, statistics and content through focused endpoints.\n- Carry usable fixture, team, player, competition and stage references between calls.\n- Display sport-specific scoring alongside form, lineups and standings context.\n- Use populated response examples and explicit coverage guidance when designing your screens.\n\n## API Categories\n\n- Discovery\n- Fixtures\n- Match\n- Competition\n- Team\n- Player\n- Content\n\n## Start Building\n\nChoose a sport, discover a fixture or entity, and combine the score, statistics, profile and content endpoints your application needs. Explore the endpoint reference on RapidAPI to build live score apps, sports websites, scoreboards and sports data experiences with the coverage appropriate to each sport and competition.", "x-website": "https://www.livescore.com/", "x-public": true, "x-thumbnail": "https://rapidapi-prod-apis.s3.amazonaws.com/eb8b18fe-3faa-4595-bf2c-0d774cff9a7f.png", "x-version-lifecycle": "active", "termsOfService": "Unofficial LiveScore sports scores and match data API." }, "tags": [ { "name": "Discovery", "description": "Find sports, timezones and usable entity identifiers. `/search` selects one entity kind by name; `/popular` selects one curated shortlist, not a complete directory. `/competitions` discovers date-addressed stages and competitions by country. Keep `competition_id` distinct from `stage_id`. `/resolve` accepts one ID family per request, with up to 50 IDs. Use `/sports` for sport identifiers and `/timezones` for supported offset examples.", "index": 0 }, { "name": "Fixtures", "description": "Read dated/live boards, competition schedules and team fixture sets. Competition and team selectors apply before board pagination; full-board counts differ from filtered/page counts, and changing snapshots can affect consecutive pages. `/day-coverage` supplies date-addressed IDs. `/league-matches` accepts published country/league slugs instead of a numeric competition ID. `/match-updates` supplies a sample of recently changing soccer fixtures, not a complete change log. Coverage varies by sport and archive date.", "index": 1 }, { "name": "Match", "description": "Use a fixture ID and its sport for focused score/state, information, lineups, key-player, statistic, incident, commentary, form, standings, editorial, video, social and cricket scorecard calls. `/match-details` owns fixture identity, scores and a shallow venue reference; `/match-info` owns detailed venue data and officials; `/match-lineups` owns substitutions; `/match-media` owns videos and `/match-social-posts` owns posts. Coverage can be null or empty by fixture and sport; the same ID does not guarantee every optional dataset.", "index": 2 }, { "name": "Competition", "description": "Read competition identities and stages, standings with available qualification/form markers, ranked player/team metrics, knockout brackets and video playlists. Leaderboard rows include available player/team identities. Request a named statistic group for a dedicated board; the default preview is not every measure. `/league-table` and `/country-competitions` use published slugs, distinct from numeric ID addresses. Cups and leagues can differ in available tables and brackets.", "index": 3 }, { "name": "Team", "description": "Read club or national-side identity, shallow competition addresses, bounded fixture windows, squads, standings, statistics and videos through their focused endpoints. `/team-competitions` supplies competition/stage addresses; `/team-fixtures` supplies nearest recent/upcoming windows, not a complete season. `/team-squad` supplies the athlete `player_id`; the adjacent `squad_player_id` identifies a registration and can numerically collide with another athlete. Team statistics require the selected competition or stage address.", "index": 4 }, { "name": "Player", "description": "Read athlete profiles, available career/appearance records and season figures. `/player-details` provides `season_id` values with their corresponding team; `/player-stats` requires that season/player/team combination rather than a numeric competition ID. Available figures can include ranks, and absent measurements are not zero. Use `/competition-player-stats` or `/team-player-stats` for ranked leaderboards rather than one athlete's figures.", "index": 5 }, { "name": "Content", "description": "Read curated or entity-scoped editorial feeds, anchored articles, country television guides, authored picks and tipster topics. Scoped news supports paging; curated news does not. `/article` puts the requested anchor first, followed by shallow suggestions; IDs can expire and locale editions differ. TV coverage varies by country and time. Picks are quoted community selections, not current sportsbook offers; `/tipster-topics` independently supplies the catalog. Counts and accepted controls are documented per dataset.", "index": 6 }, { "name": "Health", "description": "Health", "index": 7 } ], "components": { "schemas": { "CommonHealthCheckResponse": { "type": "object", "properties": { "success": { "type": "boolean", "example": true } }, "required": [ "success" ] }, "LiveScoreSuccessResponseSchema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ], "example": true }, "data": { "nullable": true } }, "required": [ "success" ] }, "LiveScoreErrorResponseSchema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ false ], "example": false }, "message": { "type": "string", "example": "An unexpected error occurred. Please try again." } }, "required": [ "success", "message" ] } }, "parameters": {} }, "paths": { "/status": { "get": { "tags": [ "Health" ], "responses": { "200": { "description": "Health check", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonHealthCheckResponse" } } } } } } }, "/sports": { "get": { "tags": [ "Discovery" ], "operationId": "/sports", "description": "List supported sports and their identifiers, ordered for the selected country.", "parameters": [ { "schema": { "type": "string", "description": "**The audience or broadcast country.** Optional; defaults to `gb`. Two-letter country code, case-insensitive.\n\nThe value selects the requested audience, not the caller's physical location. `/sports` returns the preferred sport order and reports `is_country_specific`; a code without its own ordering can use the default.\nOn `/tv-guide` it selects broadcast listings. Read `available_in_country` and `total_count`: a valid country can have no current guide, and an empty page does not establish permanent lack of coverage.\nA value that is not two letters returns 400." }, "required": false, "description": "**The audience or broadcast country.** Optional; defaults to `gb`. Two-letter country code, case-insensitive.\n\nThe value selects the requested audience, not the caller's physical location. `/sports` returns the preferred sport order and reports `is_country_specific`; a code without its own ordering can use the default.\nOn `/tv-guide` it selects broadcast listings. Read `available_in_country` and `total_count`: a valid country can have no current guide, and an empty page does not establish permanent lack of coverage.\nA value that is not two letters returns 400.", "name": "country_code", "in": "query" } ], "responses": { "200": { "description": "List the sports and their identifiers in the display order for one audience country. Use this response\nto build a sport switcher and to translate numeric `sport_id` values into the `sport` slugs other\nendpoints accept.\n\n**Country order.** `order` is a 1-based display position, not an alphabetical sort or a popularity\nscore. `is_country_specific` says whether the requested country has a dedicated order; otherwise the\ndefault is used. The recorded orders put racing second for `gb`, `uk` and `ie`, cricket second for `in`,\nAmerican football second for `us` and `mx`, and basketball second for `id` and `th`. Other markets use\nthe default order: `soccer`, `tennis`, `basketball`, `american-football`, `cricket`, `hockey`. Read the\nreturned order and flag rather than assuming a country-specific arrangement.\n\n**Two identifiers per sport.** `slug` is the request value; `id` is the number published as `sport_id`\nin match, team and competition records: `1` soccer, `2` tennis, `5` hockey, `23` basketball, `24`\nAmerican football, `31` horses and `73` cricket. `country_code` echoes the requested country in\nuppercase; omission uses the public default `GB`.\n\n**Search tabs are display hints.** `search_tabs` describes the platform's tab layout using plural names\nsuch as `teams`, `players`, `competitions` and `regions`. Search accepts singular `entity` values:\n`team`, `player`, `competition`, `country`. A missing tab does not establish that an entity search is\nunavailable; for example, cricket team search can return results without a teams tab.\n\n**Racing coverage.** `horses` appears in the recorded switcher only for `gb`, `uk` and `ie`, but\n`/competitions?sport=horses` can discover meetings for any audience. Racing is not covered by the\ntwo-sided fixture boards: `/matches-by-date` and `/live-matches` reject it with 400. Its search and\npopular lists may be empty.\n\n`live_config: false` marks a fallback sports listing; use the same identifiers and read the returned\norder. The example abridges the GB sports array to two entries; it does not show the full switcher.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "country_code": "GB", "sports": [ { "slug": "soccer", "id": 1, "order": 1, "search_tabs": [ "all", "teams" ] }, { "slug": "horses", "id": 31, "order": 2, "search_tabs": [] } ], "is_country_specific": true, "live_config": true } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/timezones": { "get": { "tags": [ "Discovery" ], "operationId": "/timezones", "description": "List supported UTC offsets for date-addressed requests, in hours.", "responses": { "200": { "description": "The common UTC offsets for a timezone picker. Each `timezones[]` entry has a numeric `offset` in hours\nthat you can send as `timezone`, and a display `label` such as `UTC+05:30`.\n\n**A convenience list, not an allowlist.** Requests accept numeric offsets from `min_offset` (`-12`)\nthrough `max_offset` (`14`), including fractional values such as `5.5` (India), `5.75` (Nepal), `-3.5`\n(Newfoundland), `8.75` (Eucla) and `12.75` (Chatham). Offsets strictly between `-1` and `0` are\nunsupported and return 400. Values outside the bounds also return 400. Send decimal hours, not\nhours-and-minutes notation: India is `5.5`, not `5.30`.\n\n**Choose the day your audience means.** On `/matches-by-date`, `/day-coverage` and `/competitions`,\n`date` and `timezone` together select a calendar day. A 20:00 UTC kickoff can fall on the following date\nat `timezone=9`. For `5.5`, a local day starts at 18:30 UTC on the previous day; for `5.75`, it starts\nat 18:15. Keep the same date and offset on related requests. Directory totals and board totals are\nseparate measurements and need not agree exactly.\n\n**Fixed offsets, without daylight-saving rules.** This is not an IANA zone-name list. Send the offset in\nforce on the date you request; London, for example, uses `0` in winter and `1` in summer. The default\noffset is `0`.\n\n**Timestamp caveat.** Competition schedules can shift `start_time` and `start_timestamp` into the\nselected offset without removing the `Z` suffix from `start_time`; dated boards can also expose shifted\nwall-clock times. Use `timezone=0` when interpreting those fields as UTC. `/live-matches` keeps UTC\nkickoff timestamps and does not select a different live window by offset.\n\n`count` is the number of entries in the full list. The example includes all 38 recorded entries and\nretains the actual bounds and explanatory note. The list is suitable to cache for a timezone picker.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "timezones": [ { "offset": -12, "label": "UTC-12:00" }, { "offset": -11, "label": "UTC-11:00" }, { "offset": -10, "label": "UTC-10:00" }, { "offset": -9.5, "label": "UTC-09:30" }, { "offset": -9, "label": "UTC-09:00" }, { "offset": -8, "label": "UTC-08:00" }, { "offset": -7, "label": "UTC-07:00" }, { "offset": -6, "label": "UTC-06:00" }, { "offset": -5, "label": "UTC-05:00" }, { "offset": -4, "label": "UTC-04:00" }, { "offset": -3.5, "label": "UTC-03:30" }, { "offset": -3, "label": "UTC-03:00" }, { "offset": -2, "label": "UTC-02:00" }, { "offset": -1, "label": "UTC-01:00" }, { "offset": 0, "label": "UTC+00:00" }, { "offset": 1, "label": "UTC+01:00" }, { "offset": 2, "label": "UTC+02:00" }, { "offset": 3, "label": "UTC+03:00" }, { "offset": 3.5, "label": "UTC+03:30" }, { "offset": 4, "label": "UTC+04:00" }, { "offset": 4.5, "label": "UTC+04:30" }, { "offset": 5, "label": "UTC+05:00" }, { "offset": 5.5, "label": "UTC+05:30" }, { "offset": 5.75, "label": "UTC+05:45" }, { "offset": 6, "label": "UTC+06:00" }, { "offset": 6.5, "label": "UTC+06:30" }, { "offset": 7, "label": "UTC+07:00" }, { "offset": 8, "label": "UTC+08:00" }, { "offset": 8.75, "label": "UTC+08:45" }, { "offset": 9, "label": "UTC+09:00" }, { "offset": 9.5, "label": "UTC+09:30" }, { "offset": 10, "label": "UTC+10:00" }, { "offset": 10.5, "label": "UTC+10:30" }, { "offset": 11, "label": "UTC+11:00" }, { "offset": 12, "label": "UTC+12:00" }, { "offset": 12.75, "label": "UTC+12:45" }, { "offset": 13, "label": "UTC+13:00" }, { "offset": 14, "label": "UTC+14:00" } ], "count": 38, "min_offset": -12, "max_offset": 14, "note": "UTC offsets from -12 to 14 hours are accepted, including fractional offsets such as 5.5, 5.75 and -3.5. Offsets strictly between -1 and 0 are unsupported and return 400. This list suggests common offsets rather than restricting requests to its entries. Daylight saving is not applied automatically: send the offset in force on the requested date." } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/table-legend": { "get": { "tags": [ "Discovery" ], "operationId": "/table-legend", "description": "List standings zones, footnotes and their colors.", "responses": { "200": { "description": "The vocabulary for qualification, promotion and relegation bands and competition footnotes on standings.\nTakes no parameters and needs no competition ID; fetch it once to build a reusable legend or color key.\n\n**Resolve bands and notes separately.** A standings row's `zone_ids` and the table's `zones[].zone_id`\njoin to `phases[].zone_id`. Table `table_marker_ids` join to `notes[].note_id`: footnotes have their own\nID space and are not bands. `/standings`, `/league-table`, `/team-standings` and `/match-standings`\nalready include available band labels and colors; this endpoint supplies the broader legend beyond the\nbands used on one table.\n\n**Band fields.** `label` is the English display name; `color` is a hex color such as `#0075FF`;\n`color_name` identifies that color in `colors`; `localization_key` joins directly to `/translations`.\nFor example, zone `20` is Champions League and `15` is Relegation. These IDs describe the band, not a\nfixed rank range: use the ranks on the actual standings table.\n\n**Footnotes and palette.** `notes[]` carries `text` and a `localization_key` where available. `colors`\nmaps color names to hex values for consistent table styling. `split_table_info` is the explanatory text\nfor a table split into groups, or null when unavailable. `phase_count` and `note_count` count the\ncomplete arrays.\n\n**Unknown and unavailable legend entries.** A standings table can publish a band that is absent from\nthis legend. Its ID and rank list can remain usable while its label or color is null; keep an unnamed\nfallback rather than treating the table as invalid. `live: false` indicates the legend is unavailable\nand its arrays are empty, even though the call succeeds. It does not mean there are no qualification\nrules for a competition.\n\nThe legend changes infrequently and is suitable to cache. The example shows two phases and two notes\nfrom the recorded 85-phase, 15-note legend, retaining the full 15-color palette and original counts; a\nsuccessful available response returns the complete arrays.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "phases": [ { "zone_id": 2, "label": "Play-off", "color_name": "purple_dark", "color": "#260755", "localization_key": "@phase_playoff" }, { "zone_id": 3, "label": "Qualification play-off", "color_name": "purple_light", "color": "#6002EE", "localization_key": "@phase_qual_playoff" } ], "phase_count": 85, "notes": [ { "note_id": 150, "text": "Cup winner qualifies for European competition.", "localization_key": "@phase_info_european_comp" }, { "note_id": 151, "text": "Cup result determines 1 spot in UEFA Europa League qualification.", "localization_key": "@phase_info_uefa_europa_league_qual" } ], "note_count": 15, "colors": { "orange_light": "#FF6B00", "orange_medium": "#B33C00", "purple_light": "#6002EE", "purple_medium": "#4304A0", "purple_dark": "#260755", "euro_2024_blue": "#0070F0", "blue_light": "#0075FF", "blue_medium": "#0350AB", "blue_dark": "#072D5B", "green_light": "#23DF8C", "green_medium": "#1A965F", "green_dark": "#125034", "red_medium": "#961A3D", "grey_light": "#AAAAAA", "yellow": "#D9E300" }, "split_table_info": "The league table has been split into 2 groups for the final part of the season.", "live": true } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/translations": { "get": { "tags": [ "Discovery" ], "operationId": "/translations", "description": "Return the interface string table for one required locale.", "parameters": [ { "schema": { "type": "string", "description": "**The language whose string table to return.** Required; accepts the documented language codes case-insensitively. The locale selects one table.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "en" }, "required": true, "description": "**The language whose string table to return.** Required; accepts the documented language codes case-insensitively. The locale selects one table.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "The interface string table for one required `locale`, returned as the flat `keys` map from exact key to\nlocalized string. There is no nested tree to traverse. Unsupported locales return 400; choose one of the\n18 values listed on the locale parameter.\n\n**Join exact keys to labels.** Standings bands and `/table-legend` publish `localization_key`; use that\nstring directly to index `keys`. Most keys start with `@`, for example `@phase_relegation`, while\n`tv_guide` does not. Preserve these prefixes rather than normalizing them. Fetch the legend and one\nlanguage table to localize subsequent tables without another lookup per band; fall back to the supplied\nlabel when a key is absent.\n\n**Counts describe strings, not translation quality.** `key_count` counts the strings in `keys`. For\nnon-English locales, `untranslated_key_count` counts values equal to their English counterpart and\n`translated_key_count` counts the rest. Identical brand names or shared words can be counted as\nuntranslated. If comparison information is unavailable, these counts can overstate translated coverage;\ninspect the strings for the labels your interface needs. For `locale=en`, translated count equals\n`key_count` and untranslated count is zero by definition.\n\n**Preserve placeholders.** Some values include substitutions such as `{brand_logo}` or positional `{0}`\nplaceholders. Supply the appropriate display value before showing them rather than rendering the\nplaceholder literally. Localization coverage varies between languages; a supported locale does not\nguarantee every value differs from English.\n\nThe recorded example contains all 316 English strings, with their original keys and counts. The same\n316-key set was recorded across the supported languages, but clients should still handle a missing key.\nCache the map per locale for repeated interface rendering.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "locale": "en", "keys": { "@acca_insight_title": "Acca Insight", "@add_live_activity": "Add Live Activity", "@add_to_livescore_bet": "Add to {brand_logo}", "@add_to_livescore_bet_android": "Add to ", "@affiliate_offers_subtitle": "New offers from our trusted partners", "@affiliate_offers_title": "Our Betting Partners", "@app_update_available": "App update available", "@apple_tv_streaming_banner_button": "Watch", "@apple_tv_streaming_banner_subtitle": "Messi battles Ronaldo as living legends lock horns - for the final time?", "@apple_tv_streaming_banner_title": "Watch on MLS Season Pass on Apple TV", "@autologin_copyrights": "*18+ only. Gamble responsibly. begambleaware.org", "@autologin_popup_carousel_follow_bets_subtitle": "See these matches on the Score Page", "@autologin_popup_carousel_follow_bets_title": "Follow Your Bets Live", "@autologin_popup_carousel_football_fav_inlsb_subtitle": "Place bets on the matches you care about", "@autologin_popup_carousel_football_fav_inlsb_title": "Quickly Access Football Matches", "@autologin_popup_carousel_win_big_with_ls6_subtitle": "Join the ultimate football prediction game. // Round closes 3pm Saturday", "@autologin_popup_carousel_win_big_with_ls6_title": "Win Big with LiveScore 6!", "@autologin_popup_subtitle": "Your LiveScore Bet account details unlocks these additional features:", "@autologin_popup_subtitle_general": "We’ve logged you in with your LiveScore Bet account for a smoother experience.", "@autologin_popup_title": "Welcome!", "@autologin_popup_title_with_name": "Welcome {0}!", "@autologin_popup_сarousel_follow_bets_subtitle": "See these matches on the Scores", "@bet_builder_game_share_text": "I’m playing {0} on LiveScore, where {1} is up for grabs. Play now for free and see if you can beat my score. ", "@bet_builder_restriction_text": "18+. Gamble responsibly. Odds subject to change.", "@bet_builder_title": "Bet Builder", "@bet_responsibly": "18+ Bet responsibly. BeGambleAware.org", "@build_your_own": "Build your own", "@contact_us_category_corrections": "Corrections", "@contact_us_category_feedback": "Feedback", "@contact_us_category_livescore_6": "LiveScore 6", "@contact_us_category_navigation": "Navigation", "@contact_us_category_queries": "Company Queries", "@contact_us_category_streaming": "Streaming", "@contact_us_category_suggestions": "Suggestions", "@contact_us_category_technical_issue": "Tech Issues", "@continue_on_livescore_bet": "Continue on {brand_logo}", "@continue_on_livescore_bet_android": "Continue on ", "@delete_account_subtitle": "Having an account with LiveScore gives you access to enhanced features as well as a great experience linking our LiveScore and LiveScore Bet apps. If you choose to continue, we will delete your LiveScore account only.", "@delete_account_title": "Can we persuade you to stay?", "@explore_order_africa": "AFRICA", "@explore_order_all": "ALL (A-Z)", "@explore_order_asia": "ASIA", "@explore_order_europe": "EUROPE", "@explore_order_international": "INTERNATIONAL", "@explore_order_north_america": "NORTH AMERICA", "@explore_order_oceania": "OCEANIA", "@explore_order_popular": "POPULAR", "@explore_order_south_america": "SOUTH AMERICA", "@feedback_survey_option1": "Faster app speed", "@feedback_survey_option2": "More live content", "@feedback_survey_option3": "Less ads", "@feedback_survey_option4": "More sports", "@feedback_survey_option5": "Other", "@feedback_survey_question": "What would you most like to improve on LiveScore?", "@for_you_sharing_message": "Don't miss this article and all the latest news on LiveScore!", "@for_you_sharing_title": "For You: Latest news", "@free_to_play_page_title": "LiveScore 6", "@global_navigation_bettings": "Betting", "@global_navigation_casino": "Casino", "@global_navigation_cheltenham": "CHELTENHAM", "@global_navigation_offers": "Offers", "@global_navigation_pick_6_1X2": "PICK 6 1X2", "@global_navigation_promotions": "PROMOTIONS", "@global_navigation_scores": "Scores", "@global_navigation_virtuals": "VIRTUALS", "@live_tv_auth_subtitle": "No catch, just sign up and enjoy the game.", "@live_tv_auth_title": "Log in to watch this match FREE on LiveScore", "@live_tv_message": "This stream will start at kickoff", "@lsbet_streaming_legal_message": "18+ Bet responsibly. BeGambleAware.org", "@maintenance_message": "We’re performing routine maintenance that may impact live score updates. Normal service will resume soon", "@maintenance_routine_general_subtitle": "We’re performing maintenance so some features won’t work as expected. If you have any issues, please try again soon.", "@maintenance_routine_push_subtitle": "We're performing routine maintenance that may impact push notification updates. Normal service will resume soon", "@maintenance_routine_scores_subtitle": "We’re performing routine maintenance that may impact live score updates. Normal service will resume soon", "@maintenance_routine_title": "Maintenance", "@maintenance_title": "Maintenance", "@market_filter_both_teams_to_score": "Both Teams to Score", "@market_filter_double_chance": "Double Chance", "@market_filter_match_result": "Match Result", "@market_filter_total_goals": "Total Goals", "@mev_watch_carousel_title": "Watch Live", "@phase_add_spots_afc_champ_league": "Championship play-off (additional spot(s) for AFC Champions League)", "@phase_add_spots_afc_champ_league_qual": "Championship play-off (additional spot(s) for AFC Champions League qualification)", "@phase_add_spots_afc_copa_libert": "Championship play-off (additional spot(s) for Copa Libertadores)", "@phase_add_spots_afc_copa_libert_qual": "Championship play-off (additional spot(s) for Copa Libertadores qualification)", "@phase_add_spots_afc_cup": "Championship play-off (additional spot(s) for AFC Cup)", "@phase_add_spots_afc_cup_qual": "Championship play-off (additional spot(s) for AFC Cup qualification)", "@phase_add_spots_afc_presidents_cup": "Championship play-off (additional spot(s) for AFC President's Cup)", "@phase_add_spots_caf_champ_league_qual": "Championship play-off (additional spot(s) for CAF Champions League qualification)", "@phase_add_spots_caf_conf_cup_qual": "Championship play-off (additional spot(s) for CAF Confederation Cup qualification)", "@phase_add_spots_cfu_club_champ": "Championship play-off (additional spot(s) for CFU Club Championship)", "@phase_add_spots_concacaf_champ_league": "Championship play-off (additional spot(s) for CONCACAF Champions League)", "@phase_add_spots_copa_sudamer": "Championship play-off (additional spot(s) for Copa Sudamericana)", "@phase_add_spots_ofc_champ_league": "Championship play-off (additional spot(s) for OFC Champions League)", "@phase_add_spots_ofc_champ_league_qual": "Championship play-off (additional spot(s) for OFC Champions League qualification)", "@phase_add_spots_uefa_champ_league": "Championship play-off (additional spot(s) for UEFA Champions League)", "@phase_add_spots_uefa_champ_league_qual": "Championship play-off (additional spot(s) for UEFA Champions League qualification)", "@phase_add_spots_uefa_europa_league": "Championship play-off (additional spot(s) for UEFA Europa League)", "@phase_add_spots_uefa_europa_league_qual": "Championship play-off (additional spot(s) for UEFA Europa League qualification)", "@phase_afc_champ_league": "AFC Champions League Elite", "@phase_afc_champ_league_qual": "AFC Champions League Elite Qualifiers", "@phase_afc_cup": "AFC Champions League 2", "@phase_afc_cup_qual": "AFC Cup qualification", "@phase_afc_presidents_cup": "AFC President's Cup", "@phase_africa_cup_of_nations": "Africa Cup of Nations", "@phase_caf_champ_league_qual": "CAF Champions League qualification", "@phase_caf_conf_cup": "CAF Confederation Cup", "@phase_caf_conf_cup_qualification": "CAF Confederation Cup qualification", "@phase_cfu_club_champ": "CFU Club Championship", "@phase_champ_eastern_conf_playoff": "Championship Eastern Conference playoff", "@phase_champ_league": "Champions League", "@phase_champ_league_qual": "Champions League qualification", "@phase_champ_playoff": "Championship play-off", "@phase_champ_western_conf_playoff": "Championship Western Conference playoff", "@phase_concacaf_champ_league": "CONCACAF Champions League", "@phase_copa_libert": "Copa Libertadores", "@phase_copa_libert_qual": "Copa Libertadores qualification", "@phase_copa_sudamer": "Copa Sudamericana", "@phase_copa_sudamer_qual": "Copa Sudamericana Qualification", "@phase_division_champ_playoff": "Division Championship Playoff", "@phase_eliminated": "Eliminated", "@phase_euro": "EURO", "@phase_europa_conf_league": "Europa Conference League", "@phase_europa_conf_league_play_off": "Europa Conference League play off", "@phase_europa_conf_league_qual": "Europa Conference League Qualification", "@phase_europa_conf_league_qual_playoff": "Europa Conference League qualification play off", "@phase_europa_league": "Europa League", "@phase_europa_league_qual": "Europa League qualification", "@phase_europa_league_qual_playoff": "Europa League qualification play-off", "@phase_final": "Final", "@phase_gives_uefa_conf_league": "Championship play-off gives UEFA Conference League (unused as of September 2020)", "@phase_gives_uefa_conf_league_qual": "Championship play-off gives UEFA Conference League qualification", "@phase_info_afc_champ_league": "Cup result determines 1 spot in AFC Champions League Elite.", "@phase_info_afc_champ_league_qual": "Cup result determines 1 spot in AFC Champions League qualification.", "@phase_info_afc_cup": "Cup result determines 1 spot in AFC Cup.", "@phase_info_afc_cup_qual": "Cup result determines 1 spot in AFC Cup qualification.", "@phase_info_caf_conf_cup_qual": "Cup result determines 1 spot in CAF Confederation Cup qualification.", "@phase_info_concacaf_cham_league": "Cup result determines 1 spot in CONCACAF Champions League.", "@phase_info_copa_libert": "Cup result determines 1 spot in Copa Libertadores.", "@phase_info_copa_sudamer": "Cup result determines 1 spot in Copa Sudamericana.", "@phase_info_dom_cup_europa_conf_league": "Domestic cup gives UEFA Europa Conference League.", "@phase_info_dom_cup_europa_conf_league_qual": "Domestic cup gives UEFA Europa Conference League qualification.", "@phase_info_europa_conf_league": "League cup gives UEFA Europa Conference League.", "@phase_info_europa_conf_league_qual": "League cup gives UEFA Europa Conference League qualification.", "@phase_info_europa_league_qual": "League Cup result determines 1 spot in UEFA Europa League qualification.", "@phase_info_european_comp": "Cup winner qualifies for European competition.", "@phase_info_uefa_europa_league_qual": "Cup result determines 1 spot in UEFA Europa League qualification.", "@phase_next_stage": "Next stage", "@phase_ofc_champ_league": "OFC Champions League", "@phase_ofc_champ_league_qual": "OFC Champions League qualification", "@phase_olympic_games": "Olympic Games", "@phase_playoff": "Play-off", "@phase_playoffs": "Play-offs", "@phase_possible_division_champ_playoff": "Possible Division Championship Playoff", "@phase_possible_qual_next_stage": "Possible qualification for the next stage", "@phase_promotion": "Promotion", "@phase_promotion_playoff": "Promotion play-off", "@phase_qual_1_slash_16_finals": "Qualification to 1/16 finals", "@phase_qual_1_slash_8_finals": "Qualification to 1/8 finals", "@phase_qual_bwt_final": "Qualification - BWT Final", "@phase_qual_copa_sudamer_final_stage": "Qualification to Copa Sudamericana Final Stage", "@phase_qual_division1": "Qualification - Division 1", "@phase_qual_division2": "Qualification - Division 2", "@phase_qual_division3": "Qualification - Division 3", "@phase_qual_eliminator": "Qualification - Eliminator", "@phase_qual_europa_conf_league_final_stage": "Qualification to Europa Conference League Final Stage", "@phase_qual_europa_league_final_stage": "Qualification to Europa League Final Stage", "@phase_qual_final": "Qualification - Final", "@phase_qual_knockout": "Qualification - Knockout", "@phase_qual_last_16": "Qualification to last 16", "@phase_qual_next_stage": "Qualification for the next stage", "@phase_qual_playoff": "Qualification play-off", "@phase_qual_qualifier": "Qualification - Qualifier", "@phase_qual_qualifier_final": "Qualification - Quarter-Final", "@phase_qual_quarter_finals": "Qualification to quarter finals", "@phase_qual_semifinal": "Qualification - Semi-Final", "@phase_qual_super12": "Qualification - Super 12", "@phase_relegation": "Relegation", "@phase_relegation_playoff": "Relegation play-off", "@phase_top_6": "Top 6", "@phase_uefa_cup": "UEFA Cup", "@phase_world_cup": "World Cup", "@preprompt_button_text": "View Cookie Preferences", "@preprompt_message_1": "Help keep LiveScore free", "@preprompt_message_2": "Personalises your experience", "@preprompt_message_3": "Enriches your content", "@preprompt_message_4": "Supports us to improve the app", "@preprompt_subtitle": "Cookie preferences do not change the number of ads that you see, only the content of them.", "@preprompt_title": "Everything’s better with cookies...", "@push_notification_assist": "Assist", "@push_notification_assists": "Assists", "@push_notification_boundaries": "Boundaries", "@push_notification_corner_kick": "Corner Kick", "@push_notification_end_of_game": "End of Game", "@push_notification_end_of_half": "End of Half", "@push_notification_end_of_set": "End of Set", "@push_notification_fall_of_wicket": "Fall of Wicket", "@push_notification_full_time_match_highlights": "Full-Time Match Highlights", "@push_notification_game_end": "Game End", "@push_notification_game_start": "Game Start", "@push_notification_goal": "Goal", "@push_notification_goals": "Goals", "@push_notification_goalscorer": "Goalscorer", "@push_notification_line_up_status": "Line-up status", "@push_notification_line_ups_confirmed": "Line-Ups Confirmed", "@push_notification_live_match_highlights": "Live Match Highlights", "@push_notification_match_end": "Match End", "@push_notification_match_highlights": "Match Highlights", "@push_notification_match_reminder": "Match Reminder", "@push_notification_match_report": "Match Reports", "@push_notification_match_start": "Match Start", "@push_notification_missed_penalty": "Missed penalty", "@push_notification_news_roundups": "News roundups", "@push_notification_non_runner": "Non Runner", "@push_notification_penalty_awarded": "Penalty", "@push_notification_penalty_missed": "Penalty Missed", "@push_notification_penalty_shootout_reminder": "Penalty Shootout Reminder", "@push_notification_period_end": "Period End", "@push_notification_period_start": "Period Start", "@push_notification_player_rating": "Player rating", "@push_notification_quarter_end": "Quarter End", "@push_notification_quarter_start": "Quarter Start", "@push_notification_race_reminder": "Race Reminder", "@push_notification_race_results": "Race Results", "@push_notification_red_card": "Red Card", "@push_notification_score_update": "Score Update", "@push_notification_session_end": "Session End", "@push_notification_start_of_half": "Start of Half", "@push_notification_sub_news_roundups": "News we think you'll want to hear", "@push_notification_substitution": "Substitution", "@push_notification_substitution_on_off": "Substitution on/off", "@push_notification_teams_confirmed": "Teams Confirmed", "@push_notification_toss_result": "Toss Result", "@push_notification_yellow_card": "Yellow Card", "@push_notification_yellow_cards": "Yellow cards", "@reg_journey_second_step_header_subtitle": "Now, verify your LiveScore Bet account to continue", "@reg_journey_second_step_title": "Verify your LiveScore Bet account", "@reg_journey_streaming_logged_in_user_subtitle": "Since you’re already a customer, you’re one step ahead to start streaming.", "@reg_journey_streaming_third_alternative_step_comment": "You must have a funded account*", "@reg_journey_streaming_third_alternative_step_cta": "Watch on", "@reg_journey_streaming_third_alternative_step_logged_in_title": "Stream live on LiveScore Bet", "@reg_journey_streaming_third_alternative_step_title": "Deposit & Watch on LiveScore Bet", "@reg_journey_third_alternative_step_cta": "Check other promos on", "@reg_journey_third_alternative_step_subtitle": "As you are already a LiveScore Bet customer, we’ve got a great range of promotions available for you.", "@reg_journey_third_alternative_step_title": "Discover more promotions for you", "@remove_live_activity": "Remove Live Activity", "@see_more": "See more", "@shortcut_add_favourite": "Add favourite teams", "@shortcut_build_up_game": "Build Up", "@shortcut_free_games": "Free Games", "@shortcut_livescore6": "LiveScore 6", "@shortcut_transfers": "Transfers", "@this_settings_will_automatically_apply": "These settings will automatically apply to any football match that you favourite", "@this_settings_will_automatically_apply_basketball": "These settings will automatically apply to any basketball match that you favourite", "@this_settings_will_automatically_apply_cricket": "These settings will automatically apply to any cricket match that you favourite", "@this_settings_will_automatically_apply_hockey": "These settings will automatically apply to any hockey match that you favourite", "@this_settings_will_automatically_apply_racing": "These settings will automatically apply to any racing that you favourite", "@this_settings_will_automatically_apply_tennis": "These settings will automatically apply to any tennis match that you favourite", "@tool_tip_add_your_favorite_teams_text": "Pin your favourite teams' matches to the top and quickly access them in one tap", "@tool_tip_add_your_favorite_teams_title": "Add your favourite teams", "@tool_tip_bet_switcher_main_text": "Get up to date odds from LiveScore Bet by turning this toggle on", "@tool_tip_bet_switcher_main_title": "Looking for Odds?", "@tool_tip_betting_feature_settings_text": "Control the betting features and adverts that you see on LiveScore in settings", "@tool_tip_betting_feature_settings_title": "Customise your betting experience", "@tool_tip_favourite_this_team_confirm_text": "Keep up to date on all matches and news for this team and tailor your notifications", "@tool_tip_favourite_this_team_confirm_title": "Favourite this team?", "@tool_tip_odds_tab_main_text": "Get the most up to date odds from the most popular markets from LiveScore Bet", "@tool_tip_odds_tab_main_title": "Looking for Odds?", "@tool_tip_quickly_access_fav_teams_text": "We’ve added a shortcuts bar so that you can access your favourite teams in one tap", "@tool_tip_quickly_access_fav_teams_title": "Quickly access favourite teams", "@tool_tip_settings_main_text": "The odds format can be easily changed within the Betting settings via the side menu", "@tool_tip_settings_main_title": "Prefer Decimal Odds?", "@tool_tip_settings_price_boosts_main_text": "You can turn off Price Boosts in Betting Settings", "@tool_tip_smart_acca_text": "Build your Acca using intelligent data and insights from LiveScore Bet", "@tool_tip_smart_acca_title": "Acca Insights", "@tool_tip_sports_moved_text": "We’ve moved other sports into the sidebar, tap here to change sports.", "@tool_tip_sports_moved_title": "Other sports have moved", "@tool_tip_team_matches_drop_down_main_text": "Tap here to choose a competition", "@tool_tip_tip_highlighted_text": "Tip:", "@tooltip_message_feed_tab": "You can access text-based commentary from Feed tab", "@tooltip_message_search": "We've made it easier to find teams, players and competitions", "@tooltip_message_summary_tab_sev": "Don’t want to see them? Tap here", "@tooltip_text_odds_toggle_default_on_mev": "Hide up to date odds from LiveScore Bet by turning this toggle off", "@tooltip_title_feed_tab": "Looking for Text Commentary?", "@tooltip_title_odds_toggle_default_on_mev": "Don’t want to see Odds?", "@tooltip_title_search": "Try our new and improved search", "@tooltip_title_summary_tab_sev": "We’ve added substitutions to this screen", "@tv_guide": "TV Guide", "@user_betting_self_restricted_info_banner_text": "Your LiveScore experience reflects your Safer Gambling preferences.", "@user_betting_self_restricted_info_body_1": "We’ve made your LiveScore experience more relevant to you by focusing on Scores and News.", "@user_betting_self_restricted_info_body_2": "To respect your safer gambling preferences, we won't show you any gambling content. This means that Odds, Bet Builders, LiveScore 6 and certain ads will be excluded from your view and any current predictions will be void.", "@user_betting_self_restricted_info_body_3": "If you have any further questions or concerns, please contact us here.", "@user_betting_self_restricted_info_title_1": "A helping hand", "@user_betting_self_restricted_info_title_2": "Just to let you know", "@user_betting_self_restricted_info_title_3": "For anything else", "@xtreme_push_betting_previews_tips": "Betting Previews and Offers", "@xtreme_push_build_up": "Build Up", "@xtreme_push_livescore_bet": "LiveScore Bet", "@xtreme_push_ls6": "LiveScore 6", "@xtreme_push_news2": "Featured News", "@xtreme_push_product_updates": "Product Updates", "@xtreme_push_promotions": "Betting offers", "@xtreme_push_streaming": "Streaming", "@xtreme_push_sub_text_build_up": "Keep up to date with our free-to-play game", "@xtreme_push_sub_text_livescore_bet": "Receive offers & promotions from LiveScore Bet", "@xtreme_push_sub_text_ls6": "Receive reminders & the latest LS6 updates", "@xtreme_push_sub_text_news2": "Get the latest featured news updates", "@xtreme_push_sub_text_product_updates": "Get the latest info and feature updates", "@xtreme_push_sub_text_promotions": "Get the latest betting offers and promotions", "@xtreme_push_sub_text_recommended_news": "News we think you’ll want to hear", "@xtreme_push_sub_text_streaming": "Get the latest video & streaming updates", "@xtreme_push_sub_text_top_headlines": "Only the biggest stories", "@xtreme_push_sub_text_transfer_news": "Done deals and latest rumours", "@xtreme_push_text_recommended_news": "Recommended news", "@xtreme_push_text_top_headlines": "Top headlines", "@xtreme_push_text_transfer_news": "Transfer news", "tv_guide": "TV Guide" }, "key_count": 316, "translated_key_count": 316, "untranslated_key_count": 0 } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/search": { "get": { "tags": [ "Discovery" ], "operationId": "/search", "description": "Find one entity kind by name.", "parameters": [ { "schema": { "type": "string", "description": "**The name to search for.** Required; three to 100 characters after trimming.\n\nSearch is case-insensitive and can match fuzzily or within a name rather than only at its beginning. The first row need not be an exact match; compare the returned name when exact selection matters.\nSearch one entity kind at a time. A name with no matches returns empty lists. Shorter queries return 400; wait until the third character for type-ahead requests. Use `/popular` to browse without a query.", "example": "arsenal" }, "required": true, "description": "**The name to search for.** Required; three to 100 characters after trimming.\n\nSearch is case-insensitive and can match fuzzily or within a name rather than only at its beginning. The first row need not be an exact match; compare the returned name when exact selection matters.\nSearch one entity kind at a time. A name with no matches returns empty lists. Shorter queries return 400; wait until the third character for type-ahead requests. Use `/popular` to browse without a query.", "name": "query", "in": "query" }, { "schema": { "type": "string", "description": "**Select one kind of entity.** Optional; defaults to `team`. Accepts team, player, competition or country. Each request returns the selected dataset. Team and player rows carry their usable IDs; competition rows may carry a stage ID without a competition ID.", "enum": [ "team", "player", "competition", "country" ], "example": "" }, "required": false, "description": "**Select one kind of entity.** Optional; defaults to `team`. Accepts team, player, competition or country. Each request returns the selected dataset. Team and player rows carry their usable IDs; competition rows may carry a stage ID without a competition ID.", "name": "entity", "in": "query" }, { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" }, { "schema": { "type": "integer", "description": "**How many results to return.** Optional; defaults to 50.\nThe limit caps the selected entity list; it does not apply independently to several lists. There is no offset or cursor pagination.\nAccepts integers from 1 to 500; values outside that range return 400.", "minimum": 1, "maximum": 500 }, "required": false, "description": "**How many results to return.** Optional; defaults to 50.\nThe limit caps the selected entity list; it does not apply independently to several lists. There is no offset or cursor pagination.\nAccepts integers from 1 to 500; values outside that range return 400.", "name": "limit", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Find one kind of entity by name and obtain the IDs needed by its endpoint family. Set `entity` to\n`team`, `player`, `competition` or `country`; omission selects `team`. Each request selects one kind, so\nmake separate requests when your interface needs more than one. `sport` defaults to `soccer` on this\nendpoint.\n\n**From a name to an address.** Team rows carry `team_id` for `/team-details`, `/team-squad` and team\nfixtures; player rows carry `player_id` for `/player-details`. Competition rows have `stage_id` and,\nwhere published, `competition_id` for `/competition-details`, `/standings` and other competition\nendpoints. Those two ID spaces are not interchangeable: a competition match with a null `competition_id`\ndoes not supply a usable competition address. Use `stage_ids` on `/resolve` to hydrate a stage. Country\nrows carry their own country ID and code.\n\n**Renderable results, with optional fields.** Lists contain names and available short names,\nabbreviations, badges or headshots; team rows can also carry country and colors. Missing image, club,\nprofile and kit fields remain null. Preserve the exact IDs and use fallback artwork when `badge_url` is\nnull.\n\n**Matching and bounds.** Queries must contain at least three characters; shorter queries return 400.\nMatching can be fuzzy, case-insensitive and accent-tolerant rather than an exact prefix: compare the\nreturned name yourself when exact identity matters. `limit` caps the selected list, defaults to `50`,\nand accepts `1` through `500`. There is no offset or cursor to page beyond this result. `locale` can\nchange the matching index as well as labels, so a name found in one language may not occur in another.\n\n**Read the selected list and its count.** The envelope retains `teams`, `players`, `competitions`,\n`countries`, their individual counts and `total_count`; unselected lists are empty. `group_order` is\noptional display guidance and can be empty, not a guaranteed relevance ranking. An empty selected list\nis a successful search with no results. `partial_errors` is empty for a successful selected lookup;\nlookup failure returns an error response rather than a partial collection of unrelated groups.\n\nCoverage varies by sport and entity. Recorded player search is strongest in soccer, with empty player\nresults in the other sports; racing search may return no results, so discover meetings through\n`/competitions?sport=horses`. IDs remain sport-scoped. Use `/popular` for a shortlist before the user\ntypes.\n\nThe populated example shows two team rows from the recorded 13-result soccer search for `arsenal`. The\nrecorded counts are retained; a real response is not limited to those two illustrated rows.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "entity": "team", "group_order": [], "teams": [ { "team_id": "2773", "name": "Arsenal", "short_name": "Arsenal", "abbreviation": "ARS", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/9825.png", "badge_file": "enet/9825.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#EF0107", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": 1, "sport": "soccer", "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, { "team_id": "3935", "name": "Arsenal W", "short_name": "Arsenal W", "abbreviation": "ARS(W)", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/teambadge/arsenal-square-2024.png", "badge_file": "teambadge/arsenal-square-2024.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#EF0107", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": 1, "sport": "soccer", "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false } ], "players": [], "competitions": [], "countries": [], "team_count": 13, "player_count": 0, "competition_count": 0, "country_count": 0, "total_count": 13, "query": "arsenal", "sport": "soccer", "partial_errors": [] } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/popular": { "get": { "tags": [ "Discovery" ], "operationId": "/popular", "description": "Read the curated shortlist for one entity kind.", "parameters": [ { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" }, { "schema": { "type": "string", "description": "**Select one kind of entity.** Optional; defaults to `team`. Accepts team, player, competition or country. Each request returns the selected dataset. Team and player rows carry their usable IDs; competition rows may carry a stage ID without a competition ID.", "enum": [ "team", "player", "competition", "country" ], "example": "" }, "required": false, "description": "**Select one kind of entity.** Optional; defaults to `team`. Accepts team, player, competition or country. Each request returns the selected dataset. Team and player rows carry their usable IDs; competition rows may carry a stage ID without a competition ID.", "name": "entity", "in": "query" }, { "schema": { "type": "integer", "description": "**How many results to return.** Optional; defaults to 30.\nThe limit caps the selected entity list; it does not apply independently to several lists. There is no offset or cursor pagination.\nAccepts integers from 1 to 100; values outside that range return 400.", "minimum": 1, "maximum": 100 }, "required": false, "description": "**How many results to return.** Optional; defaults to 30.\nThe limit caps the selected entity list; it does not apply independently to several lists. There is no offset or cursor pagination.\nAccepts integers from 1 to 100; values outside that range return 400.", "name": "limit", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read a curated shortlist before a user types a search: useful for an empty search box, a favorites\npicker or initial navigation. `entity` selects `team`, `player`, `competition` or `country`, defaulting\nto `team`; `sport` defaults to `soccer`. Request each additional entity kind separately.\n\n**Selection is editorial.** The order is a suggestion of what to show first, not a measured popularity\nscore or a stable ranking to compare over time. This is a shortlist, not an exhaustive directory. No\n`query` parameter is needed or accepted; use `/search` to find a particular name. `limit` defaults to\n`30` and accepts `1` through `100`, capping the selected list without an offset or cursor.\n\n**IDs and display fields.** Team rows carry `team_id`, names and available badges, country and colors.\nPlayer rows carry `player_id` and available headshot and club information; position, nationality and\nshirt number may be null, so use `/player-details` for a profile. Competition rows carry `stage_id` and\na nullable `competition_id`: only the latter addresses `/standings` or `/competition-details`. Country\nrows may lack a badge even when their name and ID are available; provide fallback flag artwork.\n\n**The envelope still names all four lists.** Only the selected list is populated; unselected arrays and\ncounts are empty and zero. `team_count`, `player_count`, `competition_count`, `country_count` and\n`total_count` count the returned records. `group_order` can be empty and does not establish a ranking. A\nsuccessful response has empty `partial_errors`; a failed selected lookup is reported as an error\nresponse.\n\n**Uneven coverage is normal.** Soccer has recorded shortlists across the four entity kinds. Non-soccer\nplayer lists are often empty; tennis is stronger on competitions and countries, and racing may have no\nshortlist at all. Use `/competitions?sport=horses` for dated meetings. An empty selected array means no\nshortlist was returned for that selection, not that the sport has no such entities. Keep `sport` with an\nID when using it elsewhere.\n\nThe example shows two team rows from the recorded 15-team soccer shortlist. Its original counts are\nretained; the other three kinds are unselected and correctly empty.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "entity": "team", "group_order": [], "teams": [ { "team_id": "9100", "name": "Argentina", "short_name": "Argentina", "abbreviation": "ARG", "country": "Argentina", "country_code": "ARG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/6706.png", "badge_file": "enet/6706.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#43A1D5", "secondary": "#FDFDFD" }, "is_national": true, "sport_id": 1, "sport": "soccer", "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, { "team_id": "9182", "name": "Spain", "short_name": "Spain", "abbreviation": "ESP", "country": "Spain", "country_code": "ESP", "badge_url": "https://storage.livescore.com/images/team/medium/enet/6720.png", "badge_file": "enet/6720.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#8B0D11", "secondary": "#FCB507" }, "is_national": true, "sport_id": 1, "sport": "soccer", "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false } ], "players": [], "competitions": [], "countries": [], "team_count": 15, "player_count": 0, "competition_count": 0, "country_count": 0, "total_count": 15, "sport": "soccer", "partial_errors": [] } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/competitions": { "get": { "tags": [ "Discovery" ], "operationId": "/competitions", "description": "Discover competitions and stages for a date and sport, grouped by country.", "parameters": [ { "schema": { "type": "string", "description": "**The calendar day to return.** Required, as `YYYYMMDD`: eight digits without separators, for example `20260829`.\n\nThe example is a fixed past date, not today. Replace it with the calendar day you want. Impossible dates, year zero, hyphenated dates and timestamps return 400.\nSend `timezone` alongside it when selecting a local day, and use the same pair on related boards and directories. An offset can move fixtures across midnight.\nPublished archive guidance is roughly 390 days before today and 280 days ahead, not a guarantee of complete fixtures throughout that window. Coverage can thin as dates age.\nAn empty response does not alone distinguish a quiet day from unavailable coverage. Read archive-window and completeness fields on routes that provide them.", "example": "20260829" }, "required": true, "description": "**The calendar day to return.** Required, as `YYYYMMDD`: eight digits without separators, for example `20260829`.\n\nThe example is a fixed past date, not today. Replace it with the calendar day you want. Impossible dates, year zero, hyphenated dates and timestamps return 400.\nSend `timezone` alongside it when selecting a local day, and use the same pair on related boards and directories. An offset can move fixtures across midnight.\nPublished archive guidance is roughly 390 days before today and 280 days ahead, not a guarantee of complete fixtures throughout that window. Coverage can thin as dates age.\nAn empty response does not alone distinguish a quiet day from unavailable coverage. Read archive-window and completeness fields on routes that provide them.", "name": "date", "in": "query" }, { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" }, { "schema": { "type": "number", "description": "**UTC offset in hours.** Optional; defaults to `0` (UTC). Accepts -12 through 14 as ordinary decimal hours.\n\nFractional offsets include `5.5` (India), `5.75` (Nepal) and `-3.5` (Newfoundland). Offsets strictly between -1 and 0 are unsupported and return 400.\nOn date-addressed requests the offset selects the local-day window; use the same date and offset on related boards and directories. Daylight saving is not selected automatically: send the offset in force for the requested date.\nTimestamp behavior is route-specific. Fixture schedules can contain offset-adjusted wall-clock values with a `Z` suffix; do not assume the suffix alone guarantees UTC at a nonzero offset. Live-board timestamps remain UTC and its offset does not select another live-day window. Use `0` when you need unshifted times and follow the endpoint's time guidance.", "minimum": -12, "maximum": 14 }, "required": false, "description": "**UTC offset in hours.** Optional; defaults to `0` (UTC). Accepts -12 through 14 as ordinary decimal hours.\n\nFractional offsets include `5.5` (India), `5.75` (Nepal) and `-3.5` (Newfoundland). Offsets strictly between -1 and 0 are unsupported and return 400.\nOn date-addressed requests the offset selects the local-day window; use the same date and offset on related boards and directories. Daylight saving is not selected automatically: send the offset in force for the requested date.\nTimestamp behavior is route-specific. Fixture schedules can contain offset-adjusted wall-clock values with a `Z` suffix; do not assume the suffix alone guarantees UTC at a nonzero offset. Live-board timestamps remain UTC and its offset does not select another live-day window. Use `0` when you need unshifted times and follow the endpoint's time guidance.", "name": "timezone", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Discover competitions and stages for one calendar date and sport, grouped by country or category. Use\nthis directory to build a dated competition picker, obtain slug addresses and distinguish the IDs that\nother endpoints require. `date` is a real calendar date in `YYYYMMDD`; `sport` defaults to `soccer`, and\n`timezone` to `0`.\n\n**Competition and stage IDs are separate addresses.** `competition_id` identifies the contest used by\n`/competition-details`, `/standings`, `/matches-by-competition` and competition statistics or draw\nendpoints. `stage_id` identifies a season or phase; it appears on fixture groups and can be resolved\nthrough `/resolve?stage_ids=...`. Never copy a stage ID into a competition parameter. A wrong ID can\nproduce either 404 or a valid empty result depending on the endpoint.\n\n**A directory row may have only a stage ID.** Smaller leagues, regional groups and knockout phases often\nhave `competition_id: null`. Non-soccer rows can also have stage-only identities. Null means this\nresponse does not publish a parent competition address; it does not establish that the contest has no\nfixtures. Read its slugs for `/league-matches`, select it with the dated board's country/league filters,\nor hydrate the stage with `/resolve`. Check each field instead of assuming that every discovered name\ncan feed a competition endpoint.\n\n**Counts and grouping.** `countries[]` contains a `country`, its `competitions[]`, and that country's\n`match_count` on the selected date. A competition row has identity, names, slug and available badge, not\na per-row fixture count. `country_count` counts groups; `competition_count` counts stage rows rather\nthan distinct parent competitions; `match_count` is this directory's fixture total. The country code is\na category slug such as `england`, not necessarily an ISO country code. Ordering follows the returned\ndirectory; there is no sort control. Missing badges are normal.\n\n**Date coverage.** The selected date and offset determine the local day, including fractional offsets\nsuch as `5.5` and `5.75`. Keep the same pair when calling `/matches-by-date` or `/day-coverage`. This\ndirectory's total is independent of the board's counts and can differ; use the coverage index to compare\nfixture IDs. Historical and future coverage varies and can thin to an ordinary success with `countries:\n[]`. This is a dated directory, not an all-time league list.\n\nHorse racing is discoverable here with `sport=horses`, even though `/matches-by-date` and\n`/live-matches` reject racing with 400. Use the returned directory to navigate the day's meetings rather\nthan expecting a two-sided fixture board.\n\nThe example abridges the recorded 81-country, 217-stage, 889-match directory to two country groups and\nselected rows. Counts retain the full recorded request totals and do not equal the illustrated array\nlengths.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "countries": [ { "country": { "name": "England", "code": "england", "id": "34", "iso": null }, "competitions": [ { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": "ENG" }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "has_live_tracker": null, "tier_id": null }, { "competition_id": "70", "stage_id": "25615", "name": "Championship", "short_name": "Championship", "display_name": "Championship", "slug": "championship", "competition_slug": "championship", "country": { "name": "England", "code": "england", "id": "34", "iso": "ENG" }, "badge_url": "https://storage.livescore.com/images/competition/medium/england-championship.png", "badge_file": "england-championship.png", "color": "#B90B2F", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:70", "feed_item_ids": [ "cp:70-a:4074003", "cp:70-a:4073930" ], "has_live_tracker": null, "tier_id": null } ], "match_count": 181 }, { "country": { "name": "Spain", "code": "spain", "id": "195", "iso": null }, "competitions": [ { "competition_id": "75", "stage_id": "25695", "name": "LaLiga", "short_name": "LaLiga", "display_name": "LaLiga", "slug": "laliga", "competition_slug": "laliga", "country": { "name": "Spain", "code": "spain", "id": "195", "iso": "ESP" }, "badge_url": "https://storage.livescore.com/images/competition/medium/2023-spain-laliga.png", "badge_file": "2023-spain-laliga.png", "color": "#8B0D11", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:75", "feed_item_ids": [ "cp:75-a:4073750", "cp:75-a:4073952" ], "has_live_tracker": null, "tier_id": null }, { "competition_id": "406", "stage_id": "25696", "name": "LaLiga 2", "short_name": "LaLiga 2", "display_name": "LaLiga 2", "slug": "laliga-2", "competition_slug": "laliga-2", "country": { "name": "Spain", "code": "spain", "id": "195", "iso": "ESP" }, "badge_url": "https://storage.livescore.com/images/competition/medium/2023-spain-laliga-2.png", "badge_file": "2023-spain-laliga-2.png", "color": "#8B0D11", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:406", "feed_item_ids": [ "cp:406-a:4071530", "cp:406-a:4069684" ], "has_live_tracker": null, "tier_id": null } ], "match_count": 19 } ], "country_count": 81, "competition_count": 217, "match_count": 889, "sport": "soccer", "date": "20260829", "timezone": 0 } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/resolve": { "get": { "tags": [ "Discovery" ], "operationId": "/resolve", "description": "Resolve a native batch of identifiers within exactly one ID family.", "parameters": [ { "schema": { "type": "string", "description": "**Team IDs to resolve.** Select exactly one of team_ids, player_ids, competition_ids or stage_ids per request. Supply at most 50 comma-separated numeric IDs; duplicates are read once. Unrecognized IDs are absent from the returned list.", "example": "12633,2773" }, "required": false, "description": "**Team IDs to resolve.** Select exactly one of team_ids, player_ids, competition_ids or stage_ids per request. Supply at most 50 comma-separated numeric IDs; duplicates are read once. Unrecognized IDs are absent from the returned list.", "name": "team_ids", "in": "query" }, { "schema": { "type": "string", "description": "**Player IDs to resolve.** Select exactly one of team_ids, player_ids, competition_ids or stage_ids per request. Supply at most 50 comma-separated numeric IDs; duplicates are read once. Unrecognized IDs are absent from the returned list. Use `player_id` from `/team-squad` or player search; do not substitute `squad_player_id`.", "example": "" }, "required": false, "description": "**Player IDs to resolve.** Select exactly one of team_ids, player_ids, competition_ids or stage_ids per request. Supply at most 50 comma-separated numeric IDs; duplicates are read once. Unrecognized IDs are absent from the returned list. Use `player_id` from `/team-squad` or player search; do not substitute `squad_player_id`.", "name": "player_ids", "in": "query" }, { "schema": { "type": "string", "description": "**Competition IDs to resolve.** Select exactly one of team_ids, player_ids, competition_ids or stage_ids per request. Supply at most 50 comma-separated numeric IDs; duplicates are read once. Unrecognized IDs are absent from the returned list. Competition IDs can expand to several stage records.", "example": "" }, "required": false, "description": "**Competition IDs to resolve.** Select exactly one of team_ids, player_ids, competition_ids or stage_ids per request. Supply at most 50 comma-separated numeric IDs; duplicates are read once. Unrecognized IDs are absent from the returned list. Competition IDs can expand to several stage records.", "name": "competition_ids", "in": "query" }, { "schema": { "type": "string", "description": "**Stage IDs to resolve.** Select exactly one of team_ids, player_ids, competition_ids or stage_ids per request. Supply at most 50 comma-separated numeric IDs; duplicates are read once. Unrecognized IDs are absent from the returned list.", "example": "" }, "required": false, "description": "**Stage IDs to resolve.** Select exactly one of team_ids, player_ids, competition_ids or stage_ids per request. Supply at most 50 comma-separated numeric IDs; duplicates are read once. Unrecognized IDs are absent from the returned list.", "name": "stage_ids", "in": "query" }, { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Hydrate a stored watchlist or batch of IDs into records. Supply exactly one of `team_ids`, `player_ids`,\n`competition_ids` or `stage_ids`, as a comma-separated scalar string with up to `50` IDs. Sending no\nfamily, multiple families or too many IDs returns 400. To resolve different kinds, make separate\nrequests.\n\n**Keep each ID in its own family and sport.** Team IDs come from team search, popular teams, standings\nor fixture sides. Player IDs come from `player_id` on search, squads or leaderboards. A squad's separate\n`squad_player_id` is a registration address and is not the value for `player_ids` or `/player-details`.\n`competition_ids` uses the parent contest ID; `stage_ids` uses a season or phase ID. A stage ID sent as\na competition ID can resolve nothing even though it looks numeric and valid. `sport` must match the\nsport that published the IDs; omission selects soccer.\n\n**Records and optional display fields.** Teams carry names, abbreviations, badges and available colors\nand country. Players carry available name, headshot, shirt number and club display fields; profile\nfields such as position, nationality, first/last name or `team_id` can remain null. Use `team_name` and\n`team_badge_url` when present, and `/player-details` for a profile. Resolved teams can lack\n`country_code`, `web_path` and kit fields even when search or another endpoint supplies them.\n\n**Unknown IDs are omitted.** `teams_requested`, `players_requested`, `competitions_requested` and\n`stages_requested` count the supplied IDs; unselected families have zero counts and empty arrays.\n`teams_resolved` and `players_resolved` count returned records. Compare the returned ID set to your\nrequested set to identify missing or wrong-sport entries. A batch where none resolve still succeeds with\nempty arrays; no placeholder row is created for an unknown ID. A failed lookup returns an error\nresponse; successful `partial_errors` is empty.\n\n**Competition requests can return several stages.** Both `competition_ids` and `stage_ids` produce rows\nin `competitions[]`, with `competitions_resolved` counting those rows. One parent competition ID can\nproduce several phase records, each with its own `stage_id`, so resolved count can exceed requested\ncount. There is no separate stages-resolved field. To detect a missing parent ID, group the rows by\n`competition_id` and compare IDs rather than comparing counts; for stage requests compare `stage_id`\nvalues.\n\nThe example resolves two soccer teams and retains the actual requested/resolved counts. Player and\ncompetition arrays are empty because their ID families were not selected.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "teams": [ { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": "MCI", "country": "England", "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#6CABDD", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": 1, "sport": "soccer", "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, { "team_id": "2773", "name": "Arsenal", "short_name": "Arsenal", "abbreviation": "ARS", "country": "England", "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/9825.png", "badge_file": "enet/9825.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#EF0107", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": 1, "sport": "soccer", "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false } ], "players": [], "competitions": [], "teams_resolved": 2, "players_resolved": 0, "competitions_resolved": 0, "sport": "soccer", "teams_requested": 2, "players_requested": 0, "competitions_requested": 0, "stages_requested": 0, "partial_errors": [] } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/matches-by-date": { "get": { "tags": [ "Fixtures" ], "operationId": "/matches-by-date", "description": "Read a dated fixture board, grouped by competition.", "parameters": [ { "schema": { "type": "string", "description": "**The calendar day to return.** Required, as `YYYYMMDD`: eight digits without separators, for example `20260829`.\n\nThe example is a fixed past date, not today. Replace it with the calendar day you want. Impossible dates, year zero, hyphenated dates and timestamps return 400.\nSend `timezone` alongside it when selecting a local day, and use the same pair on related boards and directories. An offset can move fixtures across midnight.\nPublished archive guidance is roughly 390 days before today and 280 days ahead, not a guarantee of complete fixtures throughout that window. Coverage can thin as dates age.\nAn empty response does not alone distinguish a quiet day from unavailable coverage. Read archive-window and completeness fields on routes that provide them.", "example": "20260829" }, "required": true, "description": "**The calendar day to return.** Required, as `YYYYMMDD`: eight digits without separators, for example `20260829`.\n\nThe example is a fixed past date, not today. Replace it with the calendar day you want. Impossible dates, year zero, hyphenated dates and timestamps return 400.\nSend `timezone` alongside it when selecting a local day, and use the same pair on related boards and directories. An offset can move fixtures across midnight.\nPublished archive guidance is roughly 390 days before today and 280 days ahead, not a guarantee of complete fixtures throughout that window. Coverage can thin as dates age.\nAn empty response does not alone distinguish a quiet day from unavailable coverage. Read archive-window and completeness fields on routes that provide them.", "name": "date", "in": "query" }, { "schema": { "type": "string", "description": "**Select one country or category.** Optional slug from competition discovery, for example `england`. Applies before pagination; an unmatched slug returns an empty board." }, "required": false, "description": "**Select one country or category.** Optional slug from competition discovery, for example `england`. Applies before pagination; an unmatched slug returns an empty board.", "name": "country_slug", "in": "query" }, { "schema": { "type": "string", "description": "**Select one league or stage slug.** Optional slug from competition discovery, for example `premier-league`. Pair it with country_slug when needed to distinguish similarly named leagues. Applies before pagination." }, "required": false, "description": "**Select one league or stage slug.** Optional slug from competition discovery, for example `premier-league`. Pair it with country_slug when needed to distinguish similarly named leagues. Applies before pagination.", "name": "league_slug", "in": "query" }, { "schema": { "type": "string", "description": "**Select a schedule view.** Optional; omission includes all states. upcoming selects NS fixtures; finished selects FT, AET and AP fixtures. Cancelled, postponed and other states are excluded from these views. Applies before pagination.", "enum": [ "upcoming", "finished" ], "example": "" }, "required": false, "description": "**Select a schedule view.** Optional; omission includes all states. upcoming selects NS fixtures; finished selects FT, AET and AP fixtures. Cancelled, postponed and other states are excluded from these views. Applies before pagination.", "name": "schedule", "in": "query" }, { "schema": { "type": "string", "description": "**The sport whose fixtures to return.** Optional; defaults to `soccer`. Accepts soccer, tennis, hockey, basketball, american-football and cricket. Use `/competitions?sport=horses` for horse-racing discovery; fixture boards do not cover horses.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "cricket" ], "example": "" }, "required": false, "description": "**The sport whose fixtures to return.** Optional; defaults to `soccer`. Accepts soccer, tennis, hockey, basketball, american-football and cricket. Use `/competitions?sport=horses` for horse-racing discovery; fixture boards do not cover horses.", "name": "sport", "in": "query" }, { "schema": { "type": "number", "description": "**UTC offset in hours.** Optional; defaults to `0` (UTC). Accepts -12 through 14 as ordinary decimal hours.\n\nFractional offsets include `5.5` (India), `5.75` (Nepal) and `-3.5` (Newfoundland). Offsets strictly between -1 and 0 are unsupported and return 400.\nOn date-addressed requests the offset selects the local-day window; use the same date and offset on related boards and directories. Daylight saving is not selected automatically: send the offset in force for the requested date.\nTimestamp behavior is route-specific. Fixture schedules can contain offset-adjusted wall-clock values with a `Z` suffix; do not assume the suffix alone guarantees UTC at a nonzero offset. Live-board timestamps remain UTC and its offset does not select another live-day window. Use `0` when you need unshifted times and follow the endpoint's time guidance.", "minimum": -12, "maximum": 14 }, "required": false, "description": "**UTC offset in hours.** Optional; defaults to `0` (UTC). Accepts -12 through 14 as ordinary decimal hours.\n\nFractional offsets include `5.5` (India), `5.75` (Nepal) and `-3.5` (Newfoundland). Offsets strictly between -1 and 0 are unsupported and return 400.\nOn date-addressed requests the offset selects the local-day window; use the same date and offset on related boards and directories. Daylight saving is not selected automatically: send the offset in force for the requested date.\nTimestamp behavior is route-specific. Fixture schedules can contain offset-adjusted wall-clock values with a `Z` suffix; do not assume the suffix alone guarantees UTC at a nonzero offset. Live-board timestamps remain UTC and its offset does not select another live-day window. Use `0` when you need unshifted times and follow the endpoint's time guidance.", "name": "timezone", "in": "query" }, { "schema": { "type": "string", "description": "**Select fixtures in one competition.** Optional; omission includes all competitions. Uses `competition_id`, not `stage_id`. Selection happens before pagination; an unmatched ID returns an empty result." }, "required": false, "description": "**Select fixtures in one competition.** Optional; omission includes all competitions. Uses `competition_id`, not `stage_id`. Selection happens before pagination; an unmatched ID returns an empty result.", "name": "competition_id", "in": "query" }, { "schema": { "type": "string", "description": "**Select fixtures involving one team.** Optional; omission includes all teams. Either home or away membership matches. Selection happens before pagination; an unmatched ID returns an empty result." }, "required": false, "description": "**Select fixtures involving one team.** Optional; omission includes all teams. Either home or away membership matches. Selection happens before pagination; an unmatched ID returns an empty result.", "name": "team_id", "in": "query" }, { "schema": { "type": "integer", "description": "**How many results to return.** Optional; defaults to 100.\n`total` counts matching fixtures before pagination; `returned` counts this page and `has_more`\nindicates whether more remain. Check board completeness separately before assuming full coverage.\nAccepts integers from 1 to 500; values outside that range return 400.", "minimum": 1, "maximum": 500 }, "required": false, "description": "**How many results to return.** Optional; defaults to 100.\n`total` counts matching fixtures before pagination; `returned` counts this page and `has_more`\nindicates whether more remain. Check board completeness separately before assuming full coverage.\nAccepts integers from 1 to 500; values outside that range return 400.", "name": "limit", "in": "query" }, { "schema": { "type": "integer", "description": "**How many results to skip.** Optional; defaults to 0. A zero-based integer from 0 to 100000. Selection happens before the page is taken; an offset beyond the result returns an empty page.\nPairs with `limit`: `limit=100&offset=0`, then `offset=100`, and so on. Fixtures can change\nbetween requests, so consecutive pages may overlap or miss fixtures when the board changes.", "minimum": 0, "maximum": 100000 }, "required": false, "description": "**How many results to skip.** Optional; defaults to 0. A zero-based integer from 0 to 100000. Selection happens before the page is taken; an offset beyond the result returns an empty page.\nPairs with `limit`: `limit=100&offset=0`, then `offset=100`, and so on. Fixtures can change\nbetween requests, so consecutive pages may overlap or miss fixtures when the board changes.", "name": "offset", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read the available fixture board for a calendar date, grouped by competition stage. Use a real\n`YYYYMMDD` date, `sport` (default `soccer`) and `timezone` (default `0`) to select the local calendar\nday. Racing is not a two-sided fixture board and returns 400 here; discover it through\n`/competitions?sport=horses`.\n\n**Select before paging.** `competition_id` selects the parent competition; `team_id` matches either home\nor away. `country_slug` selects a country/category code and `league_slug` selects the league or stage\nslug from discovery. Pair the slugs to distinguish similarly named leagues. All supplied filters must\nmatch, and empty groups are dropped. `schedule=upcoming` selects only `NS`; `schedule=finished` selects\n`FT`, `AET` and `AP`. Cancelled, postponed and other states are excluded from those views; omission\nincludes all states. An unmatched selection is a successful empty result. The competition and team\nfilters are echoed as their values or null.\n\n**Stage IDs are not competition IDs.** Some group objects have `competition_id: null` and only a\n`stage_id`. They cannot match the competition-ID filter; select them using their country/league slugs or\na participating team instead. `/resolve` accepts their stage IDs for hydration. A null competition ID\ndoes not mean the stage lacks fixtures.\n\n**Full-board counts and page counts answer different questions.** `match_count` and `competition_count`\ndescribe the board before your selection and window. The latter counts stage groups, not distinct parent\ncompetitions; compare it with `stage_count` rather than `competition_count` on `/day-coverage`. `total`\ncounts selected fixtures before pagination. `limit` defaults to `100`, accepts up to `500`, and `offset`\ndefaults to `0`. `returned` is the fixture count in this page; `has_more` is true while `offset +\nreturned < total`. The window crosses the flattened fixture order, so one page can span multiple\ncompetitions. An offset past the end returns an empty page and preserves `total`. Boards can change\nbetween calls, so reconcile by `match_id` rather than assuming consecutive pages are an immutable\nsnapshot.\n\n**Coverage verification applies to the board, not the page.** `completeness.expected_match_count` is the\ndated coverage count; `returned_match_count` is the board count before filtering or pagination.\n`complete: true` means these counts agree, not that this response contains every row or that the ID sets\nhave been compared. `false` indicates a count mismatch; null means comparison is unavailable, with\ndetails in `partial_errors`. `truncated` and `has_previous` describe board coverage/navigation\nseparately from your page. `truncated: false` does not imply `has_more: false`. `generated_at`\nidentifies the available snapshot time.\n\n**Fixture fields.** Each row carries `match_id`, home/away team identities, available names,\nabbreviations and badge URLs, scalar scores and the fuller `score` block. That block includes half-time,\nextra-time/overtime, penalties, sets, periods and innings where published; `score.raw` retains\nadditional score figures. Null is unavailable, not a recorded zero. Club colors vary and kit fields can\nbe null. `status.code` may be a fixed token such as `NS`, `HT`, `FT`, `AET` or `AP`, or a live\nclock/period such as `28'` or `2Q`; `status.label` can be null. Do not require a label to recognize a\nclock.\n\n**Cricket and time units.** When innings figures are present, use `score.innings` for runs, wickets,\novers and declarations: scalar home/away scores are null. A scalar zero without innings figures is not a\nreliable cricket score; `/match-innings` provides the detailed scorecard. `start_timestamp` is expressed\nin seconds. A nonzero timezone can shift the returned wall-clock timestamp while `start_time` retains a\n`Z` suffix; use `timezone=0` for UTC interpretation. Live-board kickoff times are UTC. Available\n`live_clock.elapsed_ms` is milliseconds in the current period and its `updated_at` is an ISO timestamp.\n\n**Quiet days and archive limits.** Coverage varies across dates and sports. `outside_archive_window:\ntrue` marks an empty board beyond the estimated archive window; a populated board never carries true.\nFalse alone does not guarantee coverage or prove that nothing was played. Compare `/day-coverage` with\nthe same date/offset and use full boards for reconciliation; `/match-updates` is only a sample of\nrecently changing soccer fixtures.\n\nThe example shows selected rows from the recorded 889-fixture, 217-group board and its 100-fixture page.\nAll board, coverage and page counts retain their actual recorded values, so they do not reconcile\nagainst the abridged arrays.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "competitions": [ { "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": null, "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "has_live_tracker": null, "tier_id": null }, "matches": [ { "match_id": "1793564", "status": { "code": "FT", "label": "Finished", "stage_id": 6, "period": 2, "winner": 0, "aggregate_winner": null }, "home": { "team_id": "3340", "name": "Liverpool", "short_name": "Liverpool", "abbreviation": "LIV", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/teambadge/liverpool-2024.png", "badge_file": "teambadge/liverpool-2024.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#C8102E", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/liverpool-2021020913320920836-92/", "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "3060", "name": "Nottingham Forest", "short_name": "Nottm Forest", "abbreviation": "FOR", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/10203.png", "badge_file": "enet/10203.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#DD0000", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/nottingham-forest-2021020913320920836-133/", "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": 2, "away_score": 2, "home_score_halftime": 0, "away_score_halftime": 1, "score": { "home": 2, "away": 2, "home_halftime": 0, "away_halftime": 1, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": 2, "away_regulation": 2, "innings": [], "raw": { "Tr1": "2", "Tr2": "2", "Trh1": "0", "Trh2": "1", "Tr1OR": "2", "Tr2OR": "2" } }, "start_time": "2026-08-29T11:30:00.000Z", "start_timestamp": 1788003000, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": null, "sport_id": 1, "sport": "soccer", "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": null, "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "has_live_tracker": null, "tier_id": null }, "round": "2", "coverage": 0, "event_type": 1, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [ { "name": "NOW", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/now.png", "logo_file": "now.png", "countries": [ "IE" ], "excluded_countries": [] }, { "name": "TNT", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": null, "logo_file": null, "countries": [ "MX" ], "excluded_countries": [] } ], "audio_streams": [], "live_action": [], "stories": [], "highlights": [], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null }, { "match_id": "1793557", "status": { "code": "FT", "label": "Finished", "stage_id": 6, "period": 2, "winner": 0, "aggregate_winner": null }, "home": { "team_id": "3928", "name": "AFC Bournemouth", "short_name": "Bournemouth", "abbreviation": "BOU", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8678.png", "badge_file": "enet/8678.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#DA291C", "secondary": "#000000" }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/bournemouth-2021020913320920836-123/", "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "2917", "name": "Everton", "short_name": "Everton", "abbreviation": "EVE", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8668.png", "badge_file": "enet/8668.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#003399", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/everton-2021020913320920836-96/", "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": 1, "away_score": 1, "home_score_halftime": 1, "away_score_halftime": 0, "score": { "home": 1, "away": 1, "home_halftime": 1, "away_halftime": 0, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": 1, "away_regulation": 1, "innings": [], "raw": { "Tr1": "1", "Tr2": "1", "Trh1": "1", "Trh2": "0", "Tr1OR": "1", "Tr2OR": "1" } }, "start_time": "2026-08-29T14:00:00.000Z", "start_timestamp": 1788012000, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": null, "sport_id": 1, "sport": "soccer", "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": null, "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "has_live_tracker": null, "tier_id": null }, "round": "2", "coverage": 0, "event_type": 1, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [ { "name": "NOW", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/now.png", "logo_file": "now.png", "countries": [ "IE" ], "excluded_countries": [] }, { "name": "FuboTV", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/fubo.png", "logo_file": "fubo.png", "countries": [ "CA", "US" ], "excluded_countries": [] } ], "audio_streams": [], "live_action": [], "stories": [], "highlights": [], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null } ] }, { "competition": { "competition_id": "75", "stage_id": "25695", "name": "LaLiga", "short_name": "LaLiga", "display_name": "LaLiga", "slug": "laliga", "competition_slug": "laliga", "country": { "name": "Spain", "code": "spain", "id": null, "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/2023-spain-laliga.png", "badge_file": "2023-spain-laliga.png", "color": "#8B0D11", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:75", "feed_item_ids": [ "cp:75-a:4073750", "cp:75-a:4073952" ], "has_live_tracker": null, "tier_id": null }, "matches": [ { "match_id": "1810693", "status": { "code": "FT", "label": "Finished", "stage_id": 6, "period": 2, "winner": 1, "aggregate_winner": null }, "home": { "team_id": "4164", "name": "Levante", "short_name": "Levante", "abbreviation": "LEV", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8581.png", "badge_file": "enet/8581.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#004182", "secondary": "#B90000" }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "3352", "name": "Real Betis", "short_name": "Real Betis", "abbreviation": "BET", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8603.png", "badge_file": "enet/8603.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#0BB363", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/real-betis-2021020913320920836-215/", "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": 5, "away_score": 2, "home_score_halftime": 2, "away_score_halftime": 2, "score": { "home": 5, "away": 2, "home_halftime": 2, "away_halftime": 2, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": 5, "away_regulation": 2, "innings": [], "raw": { "Tr1": "5", "Tr2": "2", "Trh1": "2", "Trh2": "2", "Tr1OR": "5", "Tr2OR": "2" } }, "start_time": "2026-08-29T15:00:00.000Z", "start_timestamp": 1788015600, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": null, "sport_id": 1, "sport": "soccer", "competition": { "competition_id": "75", "stage_id": "25695", "name": "LaLiga", "short_name": "LaLiga", "display_name": "LaLiga", "slug": "laliga", "competition_slug": "laliga", "country": { "name": "Spain", "code": "spain", "id": null, "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/2023-spain-laliga.png", "badge_file": "2023-spain-laliga.png", "color": "#8B0D11", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:75", "feed_item_ids": [ "cp:75-a:4073750", "cp:75-a:4073952" ], "has_live_tracker": null, "tier_id": null }, "round": "3", "coverage": 0, "event_type": 1, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [ { "name": "Canal 5", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": null, "logo_file": null, "countries": [ "MX" ], "excluded_countries": [] }, { "name": "FuboTV", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/fubo.png", "logo_file": "fubo.png", "countries": [ "US" ], "excluded_countries": [] } ], "audio_streams": [], "live_action": [], "stories": [], "highlights": [], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null }, { "match_id": "1810691", "status": { "code": "FT", "label": "Finished", "stage_id": 6, "period": 2, "winner": 1, "aggregate_winner": null }, "home": { "team_id": "4169", "name": "Real Sociedad", "short_name": "Real Sociedad", "abbreviation": "SOC", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8560.png", "badge_file": "enet/8560.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#0067B1", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/real-sociedad-2022062716001253418-202/", "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "12635", "name": "Espanyol", "short_name": "Espanyol", "abbreviation": "ESY", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8558.png", "badge_file": "enet/8558.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#0119CB", "secondary": "#FFFFFF" }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/espanyol-2021020913320920836-201/", "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": 2, "away_score": 1, "home_score_halftime": 1, "away_score_halftime": 1, "score": { "home": 2, "away": 1, "home_halftime": 1, "away_halftime": 1, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": 2, "away_regulation": 1, "innings": [], "raw": { "Tr1": "2", "Tr2": "1", "Trh1": "1", "Trh2": "1", "Tr1OR": "2", "Tr2OR": "1" } }, "start_time": "2026-08-29T17:00:00.000Z", "start_timestamp": 1788022800, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": null, "sport_id": 1, "sport": "soccer", "competition": { "competition_id": "75", "stage_id": "25695", "name": "LaLiga", "short_name": "LaLiga", "display_name": "LaLiga", "slug": "laliga", "competition_slug": "laliga", "country": { "name": "Spain", "code": "spain", "id": null, "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/2023-spain-laliga.png", "badge_file": "2023-spain-laliga.png", "color": "#8B0D11", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:75", "feed_item_ids": [ "cp:75-a:4073750", "cp:75-a:4073952" ], "has_live_tracker": null, "tier_id": null }, "round": "3", "coverage": 0, "event_type": 1, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [ { "name": "NOW", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/now.png", "logo_file": "now.png", "countries": [ "IE" ], "excluded_countries": [] }, { "name": "FuboTV", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/fubo.png", "logo_file": "fubo.png", "countries": [ "US" ], "excluded_countries": [] } ], "audio_streams": [], "live_action": [], "stories": [], "highlights": [], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null } ] } ], "match_count": 889, "competition_count": 217, "truncated": false, "has_previous": false, "generated_at": "2026-10-05T09:37:01.000Z", "sport": "soccer", "date": "20260829", "timezone": 0, "outside_archive_window": false, "completeness": { "expected_match_count": 889, "returned_match_count": 889, "complete": true }, "partial_errors": [], "competition_id": null, "team_id": null, "total": 889, "limit": 100, "offset": 0, "returned": 100, "has_more": true } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/live-matches": { "get": { "tags": [ "Fixtures" ], "operationId": "/live-matches", "description": "Read fixtures currently in play, grouped by competition.", "parameters": [ { "schema": { "type": "string", "description": "**The sport whose fixtures to return.** Optional; defaults to `soccer`. Accepts soccer, tennis, hockey, basketball, american-football and cricket. Use `/competitions?sport=horses` for horse-racing discovery; fixture boards do not cover horses.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "cricket" ], "example": "" }, "required": false, "description": "**The sport whose fixtures to return.** Optional; defaults to `soccer`. Accepts soccer, tennis, hockey, basketball, american-football and cricket. Use `/competitions?sport=horses` for horse-racing discovery; fixture boards do not cover horses.", "name": "sport", "in": "query" }, { "schema": { "type": "number", "description": "**UTC offset in hours.** Optional; defaults to `0` (UTC). Accepts -12 through 14 as ordinary decimal hours.\n\nFractional offsets include `5.5` (India), `5.75` (Nepal) and `-3.5` (Newfoundland). Offsets strictly between -1 and 0 are unsupported and return 400.\nOn date-addressed requests the offset selects the local-day window; use the same date and offset on related boards and directories. Daylight saving is not selected automatically: send the offset in force for the requested date.\nTimestamp behavior is route-specific. Fixture schedules can contain offset-adjusted wall-clock values with a `Z` suffix; do not assume the suffix alone guarantees UTC at a nonzero offset. Live-board timestamps remain UTC and its offset does not select another live-day window. Use `0` when you need unshifted times and follow the endpoint's time guidance.", "minimum": -12, "maximum": 14 }, "required": false, "description": "**UTC offset in hours.** Optional; defaults to `0` (UTC). Accepts -12 through 14 as ordinary decimal hours.\n\nFractional offsets include `5.5` (India), `5.75` (Nepal) and `-3.5` (Newfoundland). Offsets strictly between -1 and 0 are unsupported and return 400.\nOn date-addressed requests the offset selects the local-day window; use the same date and offset on related boards and directories. Daylight saving is not selected automatically: send the offset in force for the requested date.\nTimestamp behavior is route-specific. Fixture schedules can contain offset-adjusted wall-clock values with a `Z` suffix; do not assume the suffix alone guarantees UTC at a nonzero offset. Live-board timestamps remain UTC and its offset does not select another live-day window. Use `0` when you need unshifted times and follow the endpoint's time guidance.", "name": "timezone", "in": "query" }, { "schema": { "type": "string", "description": "**Select fixtures in one competition.** Optional; omission includes all competitions. Uses `competition_id`, not `stage_id`. Selection happens before pagination; an unmatched ID returns an empty result." }, "required": false, "description": "**Select fixtures in one competition.** Optional; omission includes all competitions. Uses `competition_id`, not `stage_id`. Selection happens before pagination; an unmatched ID returns an empty result.", "name": "competition_id", "in": "query" }, { "schema": { "type": "string", "description": "**Select fixtures involving one team.** Optional; omission includes all teams. Either home or away membership matches. Selection happens before pagination; an unmatched ID returns an empty result." }, "required": false, "description": "**Select fixtures involving one team.** Optional; omission includes all teams. Either home or away membership matches. Selection happens before pagination; an unmatched ID returns an empty result.", "name": "team_id", "in": "query" }, { "schema": { "type": "integer", "description": "**How many results to return.** Optional; defaults to 100.\n`total` counts matching fixtures before pagination; `returned` counts this page and `has_more`\nindicates whether more remain. Check board completeness separately before assuming full coverage.\nAccepts integers from 1 to 500; values outside that range return 400.", "minimum": 1, "maximum": 500 }, "required": false, "description": "**How many results to return.** Optional; defaults to 100.\n`total` counts matching fixtures before pagination; `returned` counts this page and `has_more`\nindicates whether more remain. Check board completeness separately before assuming full coverage.\nAccepts integers from 1 to 500; values outside that range return 400.", "name": "limit", "in": "query" }, { "schema": { "type": "integer", "description": "**How many results to skip.** Optional; defaults to 0. A zero-based integer from 0 to 100000. Selection happens before the page is taken; an offset beyond the result returns an empty page.\nPairs with `limit`: `limit=100&offset=0`, then `offset=100`, and so on. Fixtures can change\nbetween requests, so consecutive pages may overlap or miss fixtures when the board changes.", "minimum": 0, "maximum": 100000 }, "required": false, "description": "**How many results to skip.** Optional; defaults to 0. A zero-based integer from 0 to 100000. Selection happens before the page is taken; an offset beyond the result returns an empty page.\nPairs with `limit`: `limit=100&offset=0`, then `offset=100`, and so on. Fixtures can change\nbetween requests, so consecutive pages may overlap or miss fixtures when the board changes.", "name": "offset", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "The current live board, grouped by competition stage, with teams, scores and available clocks.\nA fixture may briefly remain `NS` after its scheduled kickoff. Read its status rather than\nassuming every returned fixture has started. Sport and field coverage vary.\n\n**Filtering.** `competition_id` selects a competition; `team_id` matches either home or away.\nSending both selects their intersection. Filters apply before pagination, and groups with no\nmatching fixtures are omitted. An unmatched filter returns an empty result with `200`.\nSome stages have `competition.competition_id: null` and only a `stage_id`. These IDs are not\ninterchangeable: check the unfiltered board before concluding a competition has no live matches,\nand use a participating `team_id` to select fixtures without a competition ID.\n\n**Board counts and page counts.** `match_count` and `competition_count` describe the board\nbefore your filters and page window. `competition_count` counts stage groups, not distinct\nenduring competitions. `total` counts fixtures matching your filters before pagination;\n`returned` counts fixtures in this page, and `has_more` indicates whether another page remains.\n`truncated` and `has_previous` describe board completeness/navigation, separately from your\npage: `truncated: false` does not mean every matching fixture is in this response. If the board\nis truncated, counts do not establish complete live coverage. Use `has_more` to continue paging.\n\n**Pagination.** `limit` defaults to `100`, with a maximum of `500`; `offset` defaults to `0`.\nThe window spans the ordered fixtures across groups, so a page can contain multiple competitions.\nAn offset beyond the filtered results returns an empty page with the same `total` and `200`.\nThe board changes as fixtures start, update and finish; consecutive pages can overlap or miss\nfixtures when the board changes between requests. `generated_at` identifies the snapshot time;\nthere is no guaranteed refresh interval, and more frequent polling need not yield a new snapshot.\n\n**Teams and scores.** Each fixture has `match_id`, home/away team objects with usable IDs, names\nand available badge URLs, plus `home_score`, `away_score` and the fuller `score` block.\nThat block includes half-time, extra-time/overtime and penalty figures, `sets` for set-based\nsports, and `periods` for quarter/period breakdowns. `score.raw` retains additional score figures.\nUnavailable fields are null or empty; a null score is different from a recorded zero.\n\n**Cricket.** Use `score.innings` for runs, wickets, overs and declarations. When innings figures\nare present, `home_score`, `away_score`, `score.home` and `score.away` are null. A scalar zero\nwithout innings figures is not a reliable cricket score. `result_text` can describe the result\nor state of play; `/match-innings` provides the detailed scorecard.\n\n**Status and clocks.** `status.code` can be a fixed token such as `NS`, `HT` or `FT`, or a live\nclock/period such as `28'`, `90+2'`, `S1` or `2Q`. `status.label` may be null, and a missing\ncode does not establish whether a fixture is running or finished. Cricket can have a readable\nlabel even when its code is null. Use the available status, result text and sport-specific scores\ntogether. When present, `live_clock.updated_at` is an ISO timestamp and `elapsed_ms` is elapsed\ntime in the current period, in milliseconds; `live_clock` may be null.\n\n**Times and related calls.** `start_time` is UTC ISO 8601; `start_timestamp` is Unix seconds.\n`timezone` is echoed but does not shift these timestamps or select a different live-day window;\nconvert UTC times for display. Use `/matches-by-date` for the dated board. `/match-updates` is a\nsample of recently changing soccer fixtures, not a complete change log or a replacement for boards.\n\nThe populated example is a historical snapshot, not a statement of which fixtures are live now.\nIt shows two fixtures from a five-fixture page; the recorded board and page counts are retained.\nA successful call may instead return `competitions: []` with `total: 0` when no fixtures match.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "competitions": [ { "competition": { "competition_id": null, "stage_id": "25961", "name": "Liga II", "short_name": "Liga II", "display_name": "Liga II", "slug": "liga-ii", "competition_slug": null, "country": { "name": "Romania", "code": "romania", "id": null, "iso": null }, "badge_url": null, "badge_file": null, "color": null, "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": null }, "matches": [ { "match_id": "1849024", "status": { "code": "28'", "label": null, "stage_id": 2, "period": 1, "winner": null, "aggregate_winner": null }, "home": { "team_id": "409901", "name": "Cetatea Suceava", "short_name": "Cetatea Suceava", "abbreviation": "CET", "country": null, "country_code": null, "badge_url": null, "badge_file": null, "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "409902", "name": "Popesti Leordeni", "short_name": "Popesti Leordeni", "abbreviation": "POP", "country": null, "country_code": null, "badge_url": null, "badge_file": null, "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": 0, "away_score": 0, "home_score_halftime": 0, "away_score_halftime": 0, "score": { "home": 0, "away": 0, "home_halftime": 0, "away_halftime": 0, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": null, "away_regulation": null, "innings": [], "raw": {} }, "start_time": "2026-08-29T08:00:00.000Z", "start_timestamp": 1787990400, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": null, "sport_id": 1, "sport": "soccer", "competition": { "competition_id": null, "stage_id": "25961", "name": "Liga II", "short_name": "Liga II", "display_name": "Liga II", "slug": "liga-ii", "competition_slug": null, "country": { "name": "Romania", "code": "romania", "id": null, "iso": null }, "badge_url": null, "badge_file": null, "color": null, "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": null }, "round": "5", "coverage": 0, "event_type": 1, "serving": null, "live_clock": { "updated_at": "2026-08-29T08:29:13.782Z", "elapsed_ms": 1620000 }, "has_lineups": null, "series": null, "media": { "tv_channels": [], "audio_streams": [], "live_action": [], "stories": [], "highlights": [], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null }, { "match_id": "1849028", "status": { "code": "29'", "label": null, "stage_id": 2, "period": 1, "winner": null, "aggregate_winner": null }, "home": { "team_id": "233767", "name": "CS Afumati", "short_name": "CS Afumati", "abbreviation": "CSA", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/408362.png", "badge_file": "enet/408362.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#FFFF00", "secondary": "#0000FF" }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "81903", "name": "FC Unirea 2004 Slobozia", "short_name": "FC Unirea 2004 Slobozia", "abbreviation": "FCU", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/364411.png", "badge_file": "enet/364411.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#FFFF33", "secondary": "#DD0000" }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": 1, "away_score": 0, "home_score_halftime": 1, "away_score_halftime": 0, "score": { "home": 1, "away": 0, "home_halftime": 1, "away_halftime": 0, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": null, "away_regulation": null, "innings": [], "raw": {} }, "start_time": "2026-08-29T08:00:00.000Z", "start_timestamp": 1787990400, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": null, "sport_id": 1, "sport": "soccer", "competition": { "competition_id": null, "stage_id": "25961", "name": "Liga II", "short_name": "Liga II", "display_name": "Liga II", "slug": "liga-ii", "competition_slug": null, "country": { "name": "Romania", "code": "romania", "id": null, "iso": null }, "badge_url": null, "badge_file": null, "color": null, "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": null }, "round": "5", "coverage": 0, "event_type": 1, "serving": null, "live_clock": { "updated_at": "2026-08-29T08:29:35.736Z", "elapsed_ms": 1680000 }, "has_lineups": null, "series": null, "media": { "tv_channels": [], "audio_streams": [], "live_action": [], "stories": [], "highlights": [], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null } ] } ], "match_count": 9, "competition_count": 1, "truncated": false, "has_previous": false, "generated_at": "2026-08-29T08:30:07.000Z", "sport": "soccer", "timezone": 0, "competition_id": null, "team_id": null, "total": 9, "limit": 5, "offset": 0, "returned": 5, "has_more": true } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/matches-by-competition": { "get": { "tags": [ "Fixtures" ], "operationId": "/matches-by-competition", "description": "Read fixtures for one competition.", "parameters": [ { "schema": { "type": "string", "description": "**The league, cup or tournament to read.** Required numeric identifier, sent as text.\n\nGet `competition_id` from `/competitions`, `/search?entity=competition`, `/popular?entity=competition`, `/country-competitions` or `competition.competition_id` on fixture rows.\nA competition identifies the contest; `stage_id` identifies one season or phase. The two can both look like short integers but are not interchangeable. Some fixture groups publish only a stage ID.\nUse competition IDs on competition routes; club statistics require their documented scope pairing. A league need not have a knockout draw even when its ID is valid. Unknown competitions return 404 on addressed competition reads.", "example": "65" }, "required": true, "description": "**The league, cup or tournament to read.** Required numeric identifier, sent as text.\n\nGet `competition_id` from `/competitions`, `/search?entity=competition`, `/popular?entity=competition`, `/country-competitions` or `competition.competition_id` on fixture rows.\nA competition identifies the contest; `stage_id` identifies one season or phase. The two can both look like short integers but are not interchangeable. Some fixture groups publish only a stage ID.\nUse competition IDs on competition routes; club statistics require their documented scope pairing. A league need not have a knockout draw even when its ID is valid. Unknown competitions return 404 on addressed competition reads.", "name": "competition_id", "in": "query" }, { "schema": { "type": "number", "description": "**UTC offset in hours.** Optional; defaults to `0` (UTC). Accepts -12 through 14 as ordinary decimal hours.\n\nFractional offsets include `5.5` (India), `5.75` (Nepal) and `-3.5` (Newfoundland). Offsets strictly between -1 and 0 are unsupported and return 400.\nOn date-addressed requests the offset selects the local-day window; use the same date and offset on related boards and directories. Daylight saving is not selected automatically: send the offset in force for the requested date.\nTimestamp behavior is route-specific. Fixture schedules can contain offset-adjusted wall-clock values with a `Z` suffix; do not assume the suffix alone guarantees UTC at a nonzero offset. Live-board timestamps remain UTC and its offset does not select another live-day window. Use `0` when you need unshifted times and follow the endpoint's time guidance.", "minimum": -12, "maximum": 14 }, "required": false, "description": "**UTC offset in hours.** Optional; defaults to `0` (UTC). Accepts -12 through 14 as ordinary decimal hours.\n\nFractional offsets include `5.5` (India), `5.75` (Nepal) and `-3.5` (Newfoundland). Offsets strictly between -1 and 0 are unsupported and return 400.\nOn date-addressed requests the offset selects the local-day window; use the same date and offset on related boards and directories. Daylight saving is not selected automatically: send the offset in force for the requested date.\nTimestamp behavior is route-specific. Fixture schedules can contain offset-adjusted wall-clock values with a `Z` suffix; do not assume the suffix alone guarantees UTC at a nonzero offset. Live-board timestamps remain UTC and its offset does not select another live-day window. Use `0` when you need unshifted times and follow the endpoint's time guidance.", "name": "timezone", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read the available results and upcoming fixtures for one `competition_id`, grouped by stage. This is a\ncompetition schedule view rather than a request for a single date. Coverage depends on the contest and\ncurrent publication; do not assume the response is an exhaustive season archive.\n\n**Use a parent competition address.** Obtain `competition_id` from `/competitions`,\n`/search?entity=competition`, `/popular?entity=competition` or `/resolve`. It is separate from\n`stage_id`; an ID that does not name a competition returns 404. If you hold country and league slugs,\nuse `/league-matches` instead. A valid competition with no available fixtures can return `stages: []`\nand `match_count: 0`.\n\n**Read the stage structure.** Each `stages[]` entry is `{competition, matches}`. The nested\n`competition` object carries that stage's `stage_id` and name; there is no separate stage identity field\nbeside it. A multi-phase competition can have several entries, such as group stages and knockout rounds.\nThe top-level `competition` is the contest header. `match_count` counts fixtures across all returned\nstages, without a caller page window; it is not a guarantee of fixtures absent from the published\nschedule.\n\n**Resolved sides, scores and status.** Each fixture has a `match_id`, home and away team objects with\nIDs, names, abbreviations and available badges, plus `home_score`, `away_score` and the sport-specific\n`score` block. Use `status.code` to distinguish results and upcoming ties (`FT`, `NS`, `AET`, `AP` where\napplicable); `status.label` is readable text and may be null. Extra-time and penalty figures are\nseparate score fields. Half-time figures, club colors and kit fields can be unpopulated even for\nfinished matches; use `/matches-by-date` or `/match-details` for available scoreboard detail. Missing\nvalues are null rather than zero.\n\n**Timezone shifts times, not a selected calendar day.** `timezone` defaults to `0`; this route has no\ndate boundary to choose. At a nonzero offset, `start_time` and the seconds-based `start_timestamp` can\nshift into local wall-clock time while `start_time` still ends in `Z`. Request `timezone=0` before\ninterpreting the fields as UTC. `/live-matches` keeps UTC kickoff timestamps.\n\nUse `/standings` for tables, competition statistics for leaderboards and `/competition-draw` for a\nbracket. Every available `match_id` can open `/match-details`, `/match-statistics` or `/match-lineups`;\navailability differs per fixture.\n\nThe example abridges the populated recorded schedule to selected stage/fixture rows. Its `match_count:\n380` is the original recorded total, not the length of the displayed matches and not a promise that\nevery competition has a full season available.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "competition": { "competition_id": "65", "stage_id": null, "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": null, "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": null, "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "has_live_tracker": null, "tier_id": null }, "stages": [ { "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": null, "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "has_live_tracker": null, "tier_id": null }, "matches": [ { "match_id": "1793530", "status": { "code": "FT", "label": "Finished", "stage_id": 6, "period": 2, "winner": 1, "aggregate_winner": null }, "home": { "team_id": "2773", "name": "Arsenal", "short_name": "Arsenal", "abbreviation": "ARS", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/9825.png", "badge_file": "enet/9825.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "3039", "name": "Coventry City", "short_name": "Coventry City", "abbreviation": "COV", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8669.png", "badge_file": "enet/8669.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": 3, "away_score": 0, "home_score_halftime": null, "away_score_halftime": null, "score": { "home": 3, "away": 0, "home_halftime": null, "away_halftime": null, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": null, "away_regulation": null, "innings": [], "raw": { "Tr1": "3", "Tr2": "0" } }, "start_time": "2026-08-21T19:00:00.000Z", "start_timestamp": 1787338800, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": "2026-08-21T20:52:24.000Z", "sport_id": 1, "sport": "soccer", "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": null, "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "has_live_tracker": null, "tier_id": null }, "round": "1", "coverage": 0, "event_type": 1, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [ { "name": "NOW", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/now.png", "logo_file": "now.png", "countries": [ "IE" ], "excluded_countries": [] }, { "name": "DAZN", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/dazn.png", "logo_file": "dazn.png", "countries": [ "CA" ], "excluded_countries": [] } ], "audio_streams": [], "live_action": [ { "type": "liveactions", "countries": [], "excluded_countries": [] } ], "stories": [ { "type": "Top Plays", "story_url": null, "thumbnail_url": "https://storage.livescore.com/images/story-highlights-thumbnail/high/2bffb4fd-447d-43ec-8e83-84c6d49602af_0.jpg", "thumbnail_file": "2bffb4fd-447d-43ec-8e83-84c6d49602af_0.jpg", "period": "PRE-GAME", "countries": [ "CA" ], "excluded_countries": [] }, { "type": "Highlight", "story_url": "https://stories.dazn.com/pt-pt/6a88a2ccb214b0a1db1e35d0.html?utm_source=Livescore_Syndication", "thumbnail_url": "https://storage.livescore.com/images/story-highlights-thumbnail/high/e0d88c13-ba81-40d7-b4c7-97be8b537c38_0.jpg", "thumbnail_file": "e0d88c13-ba81-40d7-b4c7-97be8b537c38_0.jpg", "period": "IN-GAME", "countries": [ "PT" ], "excluded_countries": [] } ], "highlights": [ { "type": "TwitterHighlights", "countries": [ "AU", "ZA" ], "excluded_countries": [] }, { "type": "YoutubeHighlights", "countries": [], "excluded_countries": [] } ], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null }, { "match_id": "1793553", "status": { "code": "FT", "label": "Finished", "stage_id": 6, "period": 2, "winner": 1, "aggregate_winner": null }, "home": { "team_id": "2871", "name": "Hull City", "short_name": "Hull City", "abbreviation": "HUL", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8667.png", "badge_file": "enet/8667.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "2810", "name": "Manchester United", "short_name": "Manchester United", "abbreviation": "MUN", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/10260.png", "badge_file": "enet/10260.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": 2, "away_score": 0, "home_score_halftime": null, "away_score_halftime": null, "score": { "home": 2, "away": 0, "home_halftime": null, "away_halftime": null, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": null, "away_regulation": null, "innings": [], "raw": { "Tr1": "2", "Tr2": "0" } }, "start_time": "2026-08-22T11:30:00.000Z", "start_timestamp": 1787398200, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": "2026-08-22T13:24:31.000Z", "sport_id": 1, "sport": "soccer", "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": null, "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "has_live_tracker": null, "tier_id": null }, "round": "1", "coverage": 0, "event_type": 1, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [ { "name": "NOW", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/now.png", "logo_file": "now.png", "countries": [ "IE" ], "excluded_countries": [] }, { "name": "TNT Sports 1", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/tnt-sports.png", "logo_file": "tnt-sports.png", "countries": [ "IE", "GB" ], "excluded_countries": [] } ], "audio_streams": [], "live_action": [ { "type": "liveactions", "countries": [], "excluded_countries": [] } ], "stories": [ { "type": "Top Plays", "story_url": null, "thumbnail_url": "https://storage.livescore.com/images/story-highlights-thumbnail/high/88959337-4107-455f-95db-613c51105a76_0.jpg", "thumbnail_file": "88959337-4107-455f-95db-613c51105a76_0.jpg", "period": "PRE-GAME", "countries": [ "CA" ], "excluded_countries": [] }, { "type": "Top Plays", "story_url": "https://stories.fubo.tv/games/6a8324d8fc35138db56c5cd5.html", "thumbnail_url": "https://storage.livescore.com/images/story-highlights-thumbnail/high/26384223-3742-4145-b007-84cc0abd948e_0.jpg", "thumbnail_file": "26384223-3742-4145-b007-84cc0abd948e_0.jpg", "period": "PRE-GAME", "countries": [], "excluded_countries": [ "CA" ] } ], "highlights": [ { "type": "TwitterHighlights", "countries": [ "AU", "ZA" ], "excluded_countries": [] }, { "type": "YoutubeHighlights", "countries": [], "excluded_countries": [] } ], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null } ] } ], "match_count": 380 } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/league-matches": { "get": { "tags": [ "Fixtures" ], "operationId": "/league-matches", "description": "Read a competition schedule by country_slug and league_slug.", "parameters": [ { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" }, { "schema": { "type": "string", "description": "**The country or category slug.** Required text, for example `england`.\n\nCopy `country.code` from competition discovery, `/country-competitions`, country search or a competition's public URL. This field is a slug, not a numeric country ID or two-letter audience code.\nFor league reads, pair it with `league_slug` and `sport`. Numeric IDs do not substitute for slugs. An unavailable slug/sport address can return 404; use `/matches-by-competition` or `/standings` when you hold a numeric competition ID.", "example": "england" }, "required": true, "description": "**The country or category slug.** Required text, for example `england`.\n\nCopy `country.code` from competition discovery, `/country-competitions`, country search or a competition's public URL. This field is a slug, not a numeric country ID or two-letter audience code.\nFor league reads, pair it with `league_slug` and `sport`. Numeric IDs do not substitute for slugs. An unavailable slug/sport address can return 404; use `/matches-by-competition` or `/standings` when you hold a numeric competition ID.", "name": "country_slug", "in": "query" }, { "schema": { "type": "string", "description": "**The league, cup or tournament slug.** Required text, for example `premier-league`.\n\nLook it up in `/country-competitions`, competition discovery or a public competition URL. Competition objects can expose it as `slug` or `competition_slug`; do not derive it by normalizing the name.\nSlugs can include a season or cup-round suffix. For example, `laliga` differs from the guessed `la-liga`. Pair the published value with `country_slug` and `sport`; it is not globally unique.\nA numeric competition ID is a different address. Use the numeric competition routes for IDs; an unavailable slug address returns 404 rather than silently selecting a numeric route.", "example": "premier-league" }, "required": true, "description": "**The league, cup or tournament slug.** Required text, for example `premier-league`.\n\nLook it up in `/country-competitions`, competition discovery or a public competition URL. Competition objects can expose it as `slug` or `competition_slug`; do not derive it by normalizing the name.\nSlugs can include a season or cup-round suffix. For example, `laliga` differs from the guessed `la-liga`. Pair the published value with `country_slug` and `sport`; it is not globally unique.\nA numeric competition ID is a different address. Use the numeric competition routes for IDs; an unavailable slug address returns 404 rather than silently selecting a numeric route.", "name": "league_slug", "in": "query" }, { "schema": { "type": "number", "description": "**UTC offset in hours.** Optional; defaults to `0` (UTC). Accepts -12 through 14 as ordinary decimal hours.\n\nFractional offsets include `5.5` (India), `5.75` (Nepal) and `-3.5` (Newfoundland). Offsets strictly between -1 and 0 are unsupported and return 400.\nOn date-addressed requests the offset selects the local-day window; use the same date and offset on related boards and directories. Daylight saving is not selected automatically: send the offset in force for the requested date.\nTimestamp behavior is route-specific. Fixture schedules can contain offset-adjusted wall-clock values with a `Z` suffix; do not assume the suffix alone guarantees UTC at a nonzero offset. Live-board timestamps remain UTC and its offset does not select another live-day window. Use `0` when you need unshifted times and follow the endpoint's time guidance.", "minimum": -12, "maximum": 14 }, "required": false, "description": "**UTC offset in hours.** Optional; defaults to `0` (UTC). Accepts -12 through 14 as ordinary decimal hours.\n\nFractional offsets include `5.5` (India), `5.75` (Nepal) and `-3.5` (Newfoundland). Offsets strictly between -1 and 0 are unsupported and return 400.\nOn date-addressed requests the offset selects the local-day window; use the same date and offset on related boards and directories. Daylight saving is not selected automatically: send the offset in force for the requested date.\nTimestamp behavior is route-specific. Fixture schedules can contain offset-adjusted wall-clock values with a `Z` suffix; do not assume the suffix alone guarantees UTC at a nonzero offset. Live-board timestamps remain UTC and its offset does not select another live-day window. Use `0` when you need unshifted times and follow the endpoint's time guidance.", "name": "timezone", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read a competition schedule by its sport, `country_slug` and `league_slug`, using the slug values\nreturned by competition discovery. This is the slug-addressed counterpart of `/matches-by-competition`,\nwith the same `{competition, stages, match_count}` response shape.\n\n**Choose the address you hold.** A slug pair such as `soccer/england/premier-league` avoids a separate\ncompetition-ID lookup. Both slugs are required and sport-scoped. A numeric ID is not a substitute for a\nslug; use `/matches-by-competition` when you have `competition_id`. An unknown slug address returns 404\nrather than an empty schedule. `/country-competitions` supplies published stage slugs for a country;\n`/league-table` provides the table for the same pair.\n\n**Stage and count scope.** `stages[]` entries are `{competition, matches}`, with stage identity inside\n`competition.stage_id` and its name. A slug commonly addresses one stage; cups may publish different\nslugs for separate rounds, so one slug need not cover all phases. `match_count` counts available fixture\nrows across returned stages. The schedule can contain results and upcoming ties, but coverage varies: do\nnot assume an exhaustive season or archive merely from a populated response or a familiar league name.\n\n**Available fixture fields.** Each row has `match_id`, both sides with IDs, names, abbreviations and\navailable badge URLs, scores and status. `status.code` can distinguish `FT`, `NS`, `AET` and `AP`;\n`status.label` is display text and can be null. The score block carries extra-time and penalty figures\nwhere published. Half-time scores, colors and kit fields can remain null even for completed matches;\n`/matches-by-date` or `/match-details` can supply available scoreboard detail. Null is different from a\nrecorded zero. Match IDs can open `/match-details`, `/match-statistics` or `/match-lineups`, subject to\nthat fixture's coverage.\n\n**Time units and offset caveat.** `timezone` defaults to `0` and changes rendered kickoff times rather\nthan selecting a local date, since this route takes no date parameter. Nonzero offsets can shift\n`start_time` and seconds-based `start_timestamp` into local wall-clock values while `start_time` retains\na `Z` suffix. Use `timezone=0` when interpreting them as UTC; `/live-matches` keeps UTC kickoff\ntimestamps.\n\nThe populated example shows selected stage/fixture rows from the recorded Premier League schedule.\n`match_count: 380` is its actual recorded total, retained alongside abridged arrays; it is not a\nguarantee of season-wide availability on future calls or other competitions.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": false, "is_cup": false, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "has_live_tracker": null, "tier_id": null }, "stages": [ { "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": false, "is_cup": false, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "has_live_tracker": null, "tier_id": null }, "matches": [ { "match_id": "1793530", "status": { "code": "FT", "label": "Finished", "stage_id": 6, "period": 2, "winner": 1, "aggregate_winner": null }, "home": { "team_id": "2773", "name": "Arsenal", "short_name": "Arsenal", "abbreviation": "ARS", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/9825.png", "badge_file": "enet/9825.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/arsenal-2021020913320920836-97/", "has_video": true, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "3039", "name": "Coventry City", "short_name": "Coventry City", "abbreviation": "COV", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/8669.png", "badge_file": "enet/8669.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/coventry-2022062716001253418-105/", "has_video": true, "has_squad": null, "is_placeholder": false }, "home_score": 3, "away_score": 0, "home_score_halftime": null, "away_score_halftime": null, "score": { "home": 3, "away": 0, "home_halftime": null, "away_halftime": null, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": null, "away_regulation": null, "innings": [], "raw": { "Tr1": "3", "Tr2": "0" } }, "start_time": "2026-08-21T19:00:00.000Z", "start_timestamp": 1787338800, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": "2026-08-21T20:52:24.000Z", "sport_id": 1, "sport": "soccer", "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": false, "is_cup": false, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "has_live_tracker": null, "tier_id": null }, "round": "1", "coverage": 0, "event_type": 1, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [ { "name": "NOW", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/now.png", "logo_file": "now.png", "countries": [ "IE" ], "excluded_countries": [] }, { "name": "DAZN", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/dazn.png", "logo_file": "dazn.png", "countries": [ "CA" ], "excluded_countries": [] } ], "audio_streams": [], "live_action": [ { "type": "liveactions", "countries": [], "excluded_countries": [] } ], "stories": [ { "type": "Top Plays", "story_url": null, "thumbnail_url": "https://storage.livescore.com/images/story-highlights-thumbnail/high/2bffb4fd-447d-43ec-8e83-84c6d49602af_0.jpg", "thumbnail_file": "2bffb4fd-447d-43ec-8e83-84c6d49602af_0.jpg", "period": "PRE-GAME", "countries": [ "CA" ], "excluded_countries": [] }, { "type": "Highlight", "story_url": "https://stories.dazn.com/pt-pt/6a88a2ccb214b0a1db1e35d0.html?utm_source=Livescore_Syndication", "thumbnail_url": "https://storage.livescore.com/images/story-highlights-thumbnail/high/e0d88c13-ba81-40d7-b4c7-97be8b537c38_0.jpg", "thumbnail_file": "e0d88c13-ba81-40d7-b4c7-97be8b537c38_0.jpg", "period": "IN-GAME", "countries": [ "PT" ], "excluded_countries": [] } ], "highlights": [ { "type": "TwitterHighlights", "countries": [ "AU", "ZA" ], "excluded_countries": [] }, { "type": "YoutubeHighlights", "countries": [], "excluded_countries": [] } ], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null }, { "match_id": "1793553", "status": { "code": "FT", "label": "Finished", "stage_id": 6, "period": 2, "winner": 1, "aggregate_winner": null }, "home": { "team_id": "2871", "name": "Hull City", "short_name": "Hull City", "abbreviation": "HUL", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/8667.png", "badge_file": "enet/8667.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/hull-2022062716001253418-116/", "has_video": true, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "2810", "name": "Manchester United", "short_name": "Manchester United", "abbreviation": "MUN", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/10260.png", "badge_file": "enet/10260.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/manchester-united-2021020913320920836-102/", "has_video": true, "has_squad": null, "is_placeholder": false }, "home_score": 2, "away_score": 0, "home_score_halftime": null, "away_score_halftime": null, "score": { "home": 2, "away": 0, "home_halftime": null, "away_halftime": null, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": null, "away_regulation": null, "innings": [], "raw": { "Tr1": "2", "Tr2": "0" } }, "start_time": "2026-08-22T11:30:00.000Z", "start_timestamp": 1787398200, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": "2026-08-22T13:24:31.000Z", "sport_id": 1, "sport": "soccer", "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": false, "is_cup": false, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "has_live_tracker": null, "tier_id": null }, "round": "1", "coverage": 0, "event_type": 1, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [ { "name": "NOW", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/now.png", "logo_file": "now.png", "countries": [ "IE" ], "excluded_countries": [] }, { "name": "TNT Sports 1", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/tnt-sports.png", "logo_file": "tnt-sports.png", "countries": [ "IE", "GB" ], "excluded_countries": [] } ], "audio_streams": [], "live_action": [ { "type": "liveactions", "countries": [], "excluded_countries": [] } ], "stories": [ { "type": "Top Plays", "story_url": null, "thumbnail_url": "https://storage.livescore.com/images/story-highlights-thumbnail/high/88959337-4107-455f-95db-613c51105a76_0.jpg", "thumbnail_file": "88959337-4107-455f-95db-613c51105a76_0.jpg", "period": "PRE-GAME", "countries": [ "CA" ], "excluded_countries": [] }, { "type": "Top Plays", "story_url": "https://stories.fubo.tv/games/6a8324d8fc35138db56c5cd5.html", "thumbnail_url": "https://storage.livescore.com/images/story-highlights-thumbnail/high/26384223-3742-4145-b007-84cc0abd948e_0.jpg", "thumbnail_file": "26384223-3742-4145-b007-84cc0abd948e_0.jpg", "period": "PRE-GAME", "countries": [], "excluded_countries": [ "CA" ] } ], "highlights": [ { "type": "TwitterHighlights", "countries": [ "AU", "ZA" ], "excluded_countries": [] }, { "type": "YoutubeHighlights", "countries": [], "excluded_countries": [] } ], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null } ] } ], "match_count": 380 } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/matches-by-team": { "get": { "tags": [ "Fixtures" ], "operationId": "/matches-by-team", "description": "Read fixtures for up to 50 team IDs in one sport, grouped by competition.", "parameters": [ { "schema": { "type": "string", "description": "**The teams whose fixtures to return.** Required comma-separated numeric `team_id` values, at most 50. Get IDs from team search, popular teams or fixture sides. Duplicate IDs are read once.", "example": "12633,2773,3340" }, "required": true, "description": "**The teams whose fixtures to return.** Required comma-separated numeric `team_id` values, at most 50. Get IDs from team search, popular teams or fixture sides. Duplicate IDs are read once.", "name": "team_ids", "in": "query" }, { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read the available near-term fixtures for a watchlist of up to `50` team IDs in one sport. `team_ids` is\na required comma-separated scalar string, not a repeated array parameter. `sport` defaults to `soccer`;\nuse the sport that published each ID.\n\n**A watchlist view.** IDs match either fixture side, so away trips are included. A fixture shared by two\nrequested teams can appear once; reconcile by `match_id`. Unknown or wrong-sport IDs can be omitted\nwithout failing other valid selections, and an entirely unresolved selection can return a successful\nempty board. Team IDs come from `/search?entity=team`, `/popular?entity=team`, `/resolve`, standings or\nfixture sides.\n\n**Grouping and counts.** `competitions[]` contains `{competition, matches}` groups. `match_count` is the\nnumber of available fixture rows returned; `competition_count` is the number of returned groups.\n`total_count` is the reported total when available, or null, and can exceed `match_count`; do not assume\nthe two are interchangeable. There is no offset/limit paging contract on this endpoint.\n\n**Resolved fixture fields.** Rows include `match_id`, both team objects, available names and badges,\nstatus and scores. `status.code` distinguishes completed results and upcoming fixtures; `status.label`\ncan be null. The fuller `score` block carries available half-time and sport-specific detail. Null means\nunavailable, not a recorded zero. Colors and kit fields can be null even when another endpoint has them.\n`start_time` is UTC ISO 8601 and `start_timestamp` is Unix seconds; this endpoint does not accept\ntimezone or date filters.\n\n**A variable near-term slice.** Recorded selections typically include a recent result and a handful of\nupcoming fixtures per team. The span is not a fixed date range and is not a season archive; adding teams\ncan widen the calendar span. Coverage can differ between teams and sports, and an empty response does\nnot establish that a team has no scheduled matches anywhere. Use `/matches-by-date` for a selected local\nday, `/matches-by-competition` for the available competition schedule, or `/team-fixtures` for one\nteam's recent/upcoming view with competition and stage selection.\n\nThe example shows selected fixture rows from the populated eight-fixture, two-group response.\n`match_count` and `total_count` retain the recorded value `8`; they describe the original call rather\nthan the abridged rows shown.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "competitions": [ { "competition": { "competition_id": "60", "stage_id": "26261", "name": "League Stage", "short_name": "League Stage", "display_name": "League Stage", "slug": "league-stage", "competition_slug": "champions-league", "country": { "name": "Champions League", "code": "champions-league", "id": "130", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/2023-champions-league.png", "badge_file": "2023-champions-league.png", "color": "#152E58", "sport_id": 1, "sport": "soccer", "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": null }, "matches": [ { "match_id": "1882760", "status": { "code": "NS", "label": "Not started", "stage_id": 1, "period": 0, "winner": null, "aggregate_winner": null }, "home": { "team_id": "2773", "name": "Arsenal", "short_name": "Arsenal", "abbreviation": "ARS", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/9825.png", "badge_file": "enet/9825.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": true, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "3880", "name": "Lille", "short_name": "Lille", "abbreviation": "LIL", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8639.png", "badge_file": "enet/8639.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": true, "has_squad": null, "is_placeholder": false }, "home_score": null, "away_score": null, "home_score_halftime": null, "away_score_halftime": null, "score": { "home": null, "away": null, "home_halftime": null, "away_halftime": null, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": null, "away_regulation": null, "innings": [], "raw": {} }, "start_time": "2026-10-13T19:00:00.000Z", "start_timestamp": 1791918000, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": null, "sport_id": 1, "sport": "soccer", "competition": { "competition_id": "60", "stage_id": "26261", "name": "League Stage", "short_name": "League Stage", "display_name": "League Stage", "slug": "league-stage", "competition_slug": "champions-league", "country": { "name": "Champions League", "code": "champions-league", "id": "130", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/2023-champions-league.png", "badge_file": "2023-champions-league.png", "color": "#152E58", "sport_id": 1, "sport": "soccer", "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": null }, "round": "2", "coverage": 0, "event_type": 1, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [], "audio_streams": [], "live_action": [], "stories": [], "highlights": [], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null }, { "match_id": "1882862", "status": { "code": "NS", "label": "Not started", "stage_id": 1, "period": 0, "winner": null, "aggregate_winner": null }, "home": { "team_id": "5268", "name": "LASK", "short_name": "LASK", "abbreviation": "LAS", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/9977.png", "badge_file": "enet/9977.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": true, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "3340", "name": "Liverpool", "short_name": "Liverpool", "abbreviation": "LIV", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/teambadge/liverpool-2024.png", "badge_file": "teambadge/liverpool-2024.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": true, "has_squad": null, "is_placeholder": false }, "home_score": null, "away_score": null, "home_score_halftime": null, "away_score_halftime": null, "score": { "home": null, "away": null, "home_halftime": null, "away_halftime": null, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": null, "away_regulation": null, "innings": [], "raw": {} }, "start_time": "2026-10-14T16:45:00.000Z", "start_timestamp": 1791996300, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": null, "sport_id": 1, "sport": "soccer", "competition": { "competition_id": "60", "stage_id": "26261", "name": "League Stage", "short_name": "League Stage", "display_name": "League Stage", "slug": "league-stage", "competition_slug": "champions-league", "country": { "name": "Champions League", "code": "champions-league", "id": "130", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/2023-champions-league.png", "badge_file": "2023-champions-league.png", "color": "#152E58", "sport_id": 1, "sport": "soccer", "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": null }, "round": "2", "coverage": 0, "event_type": 1, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [], "audio_streams": [], "live_action": [], "stories": [], "highlights": [], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null } ] }, { "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": 1, "sport": "soccer", "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": null }, "matches": [ { "match_id": "1793569", "status": { "code": "NS", "label": "Not started", "stage_id": 1, "period": 0, "winner": null, "aggregate_winner": null }, "home": { "team_id": "2773", "name": "Arsenal", "short_name": "Arsenal", "abbreviation": "ARS", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/9825.png", "badge_file": "enet/9825.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": true, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "3143", "name": "Leeds United", "short_name": "Leeds United", "abbreviation": "LEE", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8463.png", "badge_file": "enet/8463.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": true, "has_squad": null, "is_placeholder": false }, "home_score": null, "away_score": null, "home_score_halftime": null, "away_score_halftime": null, "score": { "home": null, "away": null, "home_halftime": null, "away_halftime": null, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": null, "away_regulation": null, "innings": [], "raw": {} }, "start_time": "2026-10-10T11:30:00.000Z", "start_timestamp": 1791631800, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": null, "sport_id": 1, "sport": "soccer", "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": 1, "sport": "soccer", "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": null }, "round": "6", "coverage": 0, "event_type": 1, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [], "audio_streams": [], "live_action": [], "stories": [], "highlights": [], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null }, { "match_id": "1793576", "status": { "code": "NS", "label": "Not started", "stage_id": 1, "period": 0, "winner": null, "aggregate_winner": null }, "home": { "team_id": "3340", "name": "Liverpool", "short_name": "Liverpool", "abbreviation": "LIV", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/teambadge/liverpool-2024.png", "badge_file": "teambadge/liverpool-2024.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": true, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": "MCI", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": true, "has_squad": null, "is_placeholder": false }, "home_score": null, "away_score": null, "home_score_halftime": null, "away_score_halftime": null, "score": { "home": null, "away": null, "home_halftime": null, "away_halftime": null, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": null, "away_regulation": null, "innings": [], "raw": {} }, "start_time": "2026-10-11T15:30:00.000Z", "start_timestamp": 1791732600, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": null, "sport_id": 1, "sport": "soccer", "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": 1, "sport": "soccer", "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": null }, "round": "6", "coverage": 0, "event_type": 1, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [], "audio_streams": [], "live_action": [], "stories": [], "highlights": [], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null } ] } ], "match_count": 8, "total_count": 8, "competition_count": 2 } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/match-updates": { "get": { "tags": [ "Fixtures" ], "operationId": "/match-updates", "description": "Read a sample of recently changing soccer fixtures.", "parameters": [ { "schema": { "type": "string", "description": "**The sport whose changes to return.** Optional; defaults to `soccer`, the supported delta-feed sport.", "enum": [ "soccer" ], "example": "" }, "required": false, "description": "**The sport whose changes to return.** Optional; defaults to `soccer`, the supported delta-feed sport.", "name": "sport", "in": "query" }, { "schema": { "type": "integer", "description": "**Changes since this timestamp, in Unix seconds.** Optional; omission selects the last minute.\n\nSend the numeric `cursor` from the previous response as `since`; there is no `cursor` query parameter.\n`cursor_time` is the same value in ISO form for display. A null cursor gives no continuation timestamp.\n\nAccepts integers from `0` through `4102444800`. Millisecond timestamps, fractions and out-of-range\nvalues return 400. This is a recent sample, not an archive: an old timestamp does not guarantee replay\nof missed updates. After an absence, reconcile through `/matches-by-date` or `/live-matches`.", "minimum": 0, "maximum": 4102444800 }, "required": false, "description": "**Changes since this timestamp, in Unix seconds.** Optional; omission selects the last minute.\n\nSend the numeric `cursor` from the previous response as `since`; there is no `cursor` query parameter.\n`cursor_time` is the same value in ISO form for display. A null cursor gives no continuation timestamp.\n\nAccepts integers from `0` through `4102444800`. Millisecond timestamps, fractions and out-of-range\nvalues return 400. This is a recent sample, not an archive: an old timestamp does not guarantee replay\nof missed updates. After an absence, reconcile through `/matches-by-date` or `/live-matches`.", "name": "since", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read a sample of recently changing soccer fixtures, with partial rows you can merge onto a board. This\nfeed is not a complete change log: a fixture can change without appearing here, and an empty response\ndoes not prove that every score is unchanged.\n\n**Cursor workflow and units.** Omit `since` for the recent one-minute interval. When `cursor` is\nnon-null, send its numeric value as the next `since`; there is no `cursor` query parameter. Both are\nUnix seconds, while `cursor_time` is the corresponding ISO timestamp for display or logging. `since`\naccepts integers from `0` through `4102444800`; millisecond timestamps and values outside those bounds\nreturn 400. A null cursor supplies no continuation value: obtain another current response rather than\nsending null as a timestamp.\n\n**Merge partial rows by `match_id`.** Typical updates contain only the ID, `home_score`, `away_score`\nand a partial `score` block. Missing fields supply no replacement value: keep the team identities,\ncompetition, kickoff and status you already hold. Merge only the present keys, including present nested\nscore keys; replacing an entire score object can discard half-time or other breakdowns. Recorded zeros\nare real values and must be applied. A null `match_id` cannot safely identify a stored fixture, so\nreconcile it through a full board instead.\n\n**Reconcile from full snapshots.** Start with `/matches-by-date` or `/live-matches`, apply usable\nsampled updates between board reads, and refresh the board to cover changes this feed omitted. After a\nlong absence, rebuild from a board instead of expecting an old cursor to replay missed changes. This is\na recent buffer rather than an archive; widening `since` does not guarantee a wider history. No polling\ninterval or complete delivery is guaranteed. `/day-coverage` helps compare the IDs available for a dated\nboard, but is not itself a score-change log.\n\n**Empty and populated responses.** `matches: []` with `match_count: 0` is a valid quiet sample. Take a\nusable new cursor and continue according to your refresh policy. `match_count` counts the sample rows\nreturned, not every changing fixture or the number of live matches.\n\nThe populated example is a historical snapshot of two score patches with its original `cursor`,\n`cursor_time` and `match_count`. It illustrates partial rows, not fixtures changing now; a current call\nmay return an empty sample.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "matches": [ { "match_id": "1816023", "home_score": 0, "away_score": 0, "score": { "home": 0, "away": 0, "raw": { "Tr1": "0", "Tr2": "0" } } }, { "match_id": "1815110", "home_score": 0, "away_score": 0, "score": { "home": 0, "away": 0, "raw": { "Tr1": "0", "Tr2": "0" } } } ], "match_count": 2, "cursor": 1788688814, "cursor_time": "2026-09-06T10:00:14.000Z" } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/day-coverage": { "get": { "tags": [ "Fixtures" ], "operationId": "/day-coverage", "description": "Read the match, stage, competition and participant IDs covered on a calendar date.", "parameters": [ { "schema": { "type": "string", "description": "**The calendar day to return.** Required, as `YYYYMMDD`: eight digits without separators, for example `20260829`.\n\nThe example is a fixed past date, not today. Replace it with the calendar day you want. Impossible dates, year zero, hyphenated dates and timestamps return 400.\nSend `timezone` alongside it when selecting a local day, and use the same pair on related boards and directories. An offset can move fixtures across midnight.\nPublished archive guidance is roughly 390 days before today and 280 days ahead, not a guarantee of complete fixtures throughout that window. Coverage can thin as dates age.\nAn empty response does not alone distinguish a quiet day from unavailable coverage. Read archive-window and completeness fields on routes that provide them.", "example": "20260829" }, "required": true, "description": "**The calendar day to return.** Required, as `YYYYMMDD`: eight digits without separators, for example `20260829`.\n\nThe example is a fixed past date, not today. Replace it with the calendar day you want. Impossible dates, year zero, hyphenated dates and timestamps return 400.\nSend `timezone` alongside it when selecting a local day, and use the same pair on related boards and directories. An offset can move fixtures across midnight.\nPublished archive guidance is roughly 390 days before today and 280 days ahead, not a guarantee of complete fixtures throughout that window. Coverage can thin as dates age.\nAn empty response does not alone distinguish a quiet day from unavailable coverage. Read archive-window and completeness fields on routes that provide them.", "name": "date", "in": "query" }, { "schema": { "type": "string", "description": "**The sport whose fixtures to return.** Optional; defaults to `soccer`. Accepts soccer, tennis, hockey, basketball, american-football and cricket. Use `/competitions?sport=horses` for horse-racing discovery; fixture boards do not cover horses.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "cricket" ], "example": "" }, "required": false, "description": "**The sport whose fixtures to return.** Optional; defaults to `soccer`. Accepts soccer, tennis, hockey, basketball, american-football and cricket. Use `/competitions?sport=horses` for horse-racing discovery; fixture boards do not cover horses.", "name": "sport", "in": "query" }, { "schema": { "type": "number", "description": "**UTC offset in hours.** Optional; defaults to `0` (UTC). Accepts -12 through 14 as ordinary decimal hours.\n\nFractional offsets include `5.5` (India), `5.75` (Nepal) and `-3.5` (Newfoundland). Offsets strictly between -1 and 0 are unsupported and return 400.\nOn date-addressed requests the offset selects the local-day window; use the same date and offset on related boards and directories. Daylight saving is not selected automatically: send the offset in force for the requested date.\nTimestamp behavior is route-specific. Fixture schedules can contain offset-adjusted wall-clock values with a `Z` suffix; do not assume the suffix alone guarantees UTC at a nonzero offset. Live-board timestamps remain UTC and its offset does not select another live-day window. Use `0` when you need unshifted times and follow the endpoint's time guidance.", "minimum": -12, "maximum": 14 }, "required": false, "description": "**UTC offset in hours.** Optional; defaults to `0` (UTC). Accepts -12 through 14 as ordinary decimal hours.\n\nFractional offsets include `5.5` (India), `5.75` (Nepal) and `-3.5` (Newfoundland). Offsets strictly between -1 and 0 are unsupported and return 400.\nOn date-addressed requests the offset selects the local-day window; use the same date and offset on related boards and directories. Daylight saving is not selected automatically: send the offset in force for the requested date.\nTimestamp behavior is route-specific. Fixture schedules can contain offset-adjusted wall-clock values with a `Z` suffix; do not assume the suffix alone guarantees UTC at a nonzero offset. Live-board timestamps remain UTC and its offset does not select another live-day window. Use `0` when you need unshifted times and follow the endpoint's time guidance.", "name": "timezone", "in": "query" } ], "responses": { "200": { "description": "Read the available IDs for one local calendar day without returning full fixture objects. Send a real\n`YYYYMMDD` date and the same `sport` and `timezone` as the related board; defaults are soccer and UTC.\nRacing is not covered by this fixture index and returns 400.\n\n**Four lists with separate counts.** `match_ids` joins to fixture `match_id`; `competition_ids` contains\nparent contest IDs; `stage_ids` contains season/phase IDs; `participant_ids` identifies participants.\nEach is an array of ID strings. `match_count`, `competition_count`, `stage_count` and\n`participant_count` are the lengths of their corresponding lists in an actual response. There is no\ncombined grand total or singular ID field, and no caller pagination.\n\n**Use each ID in its own space.** Match IDs open `/match-details` and the focused match endpoints.\nParent competition IDs address `/competition-details`, `/standings` and `/matches-by-competition`. Stage\nIDs can be hydrated with `/resolve?stage_ids=...` and used by endpoints explicitly accepting `stage_id`;\nthey cannot substitute for a `competition_id`. Keep the requested sport with all IDs.\n\n**Board comparison.** Compare `match_ids` against the `match_id` set you have collected from all pages\nof `/matches-by-date`, with the same date, sport and timezone. That board's completeness counts relate to this\nindex, before its filters and pagination. `competition_count` here counts the published parent\ncompetition IDs, whereas the board's `competition_count` counts stage groups; `stage_count` is the\ncorresponding stage-level figure. Do not compare the two competition counts as if they measured the same\nthing.\n\n**Participants are not squad members.** On team sports the index commonly reflects the fixture sides.\nIndividual sports can also include individual players beyond the side IDs on the board. Do not use\n`participant_ids` as a roster or assume that every ID can be addressed as a club.\n\n**Reconciliation and limits.** Compare lists as sets rather than relying on their order. Two snapshots\ncan help identify IDs added or removed from the published day's coverage, but separate requests are not\nan atomic snapshot and can differ while fixtures are updated. This index describes available coverage,\nnot proof of every real-world match. `timezone` moves the local day boundary; fixed offsets require you\nto account for daylight saving on the requested date. This endpoint does not accept locale.\n\n`outside_archive_window: true` marks an empty index beyond the estimated archive window; a populated\nindex never carries true. A successful empty response with false can also occur on an uncovered or quiet\nday, so false does not guarantee completeness. Historical and future availability varies.\n\nThe example abridges each ID list to two entries while retaining the recorded counts: `889` matches,\n`75` competitions, `217` stages and `1778` participants. Only the illustrated example has counts greater\nthan its shortened lists; actual response counts equal their list lengths.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "match_ids": [ "1711392", "1711415" ], "competition_ids": [ "515", "759" ], "stage_ids": [ "24234", "24463" ], "participant_ids": [ "10630", "349779" ], "match_count": 889, "competition_count": 75, "stage_count": 217, "participant_count": 1778, "sport": "soccer", "date": "20260829", "timezone": 0, "outside_archive_window": false } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/match-details": { "get": { "tags": [ "Match" ], "operationId": "/match-details", "description": "Read one fixture's identity, sides, score, state and kickoff times.", "parameters": [ { "schema": { "type": "string", "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "example": "1793566" }, "required": true, "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "name": "match_id", "in": "query" }, { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read one fixture's identity, sides, score, state and times. The response contains `match`,\n`venue`, `lineups_updated_at` and `partial_errors`.\n\n**Fixture and side identity.** `match.home` and `match.away` are nullable team objects with `team_id`, names,\nabbreviation, country, badge and kit artwork, goalkeeper artwork and text colors where available, and\n`colors.primary` / `colors.secondary`. `is_national` identifies a national side and `is_placeholder` an\nunfilled fixture slot; nullable `has_video` / `has_squad` are availability hints. Side `sport_id` / `sport`\nand `web_path` are supplied where known. Use the absolute image URLs for display; the companion file values\nidentify the artwork. `competition` identifies the competition and its `stage_id`, country and badge; `round`\nidentifies the round when supplied. Competition names include full, short and display forms; `slug` /\n`competition_slug` identify its paths, `country` supplies name/code/ID/ISO, and `color`, `is_cup`,\n`has_cup_draw`, `has_live_tracker` and `tier_id` are conditional metadata. `feed_id` / `feed_item_ids`\nidentify related content feeds. Team and competition fields depend on coverage rather than being a full\ndetails record.\n\n**Scores by sport.** `home_score` / `away_score` mirror `score.home` / `score.away`; halftime values are also\navailable both at the top level and in `score`. Missing scores are `null`, while an actual zero is kept as\n`0`.\n\n- `score.home_regulation` / `away_regulation` describe normal time; extra-time or overtime values and penalty\n scores have separate home/away fields. They can differ from the final score.\n- Tennis uses `sets[]` with the set number, home/away scores and optional tiebreak points. `home_game_points`\n / `away_game_points` are numeric; use the corresponding `*_display` values to show a nonnumeric value such\n as advantage (`\"A\"`).\n- Basketball and American football can carry `periods[]` labelled `Q1`–`Q4`; hockey can carry `P1`–`P3`. Each\n entry has `period`, `label`, `home` and `away`. The overall score includes any additional play represented\n separately by the overtime fields.\n- Cricket uses `score.innings[]`: the innings number, `side` (`home` or `away`), runs, wickets, overs and\n declaration flag. When innings are present, the ordinary score pair is `null`. Overs use cricket ball\n notation: `14.5` means 14 overs and five balls. `result_text` and `event_type_text` provide the published\n result and event description where available; `/match-innings` supplies the full cards.\n\n`score.raw` retains additional recorded score values. Score variants and lists stay `null` or empty when they\ndo not apply or are not published; do not infer a completed result from an absent field.\n\n**State and clocks.** Branch on `status.code` for fixed states such as `NS`, `HT`, `FT` and `AET`. During\nfootball play it can instead contain a minute such as `29'`; `status.label` can then be `null`. Cricket may\nhave `code: null` with a published status label, so display the available label or `result_text` rather than\nrequiring both status fields. `status.winner` is `1` home, `2` away or `0` draw or undecided when supplied.\n`aggregate_winner` applies to a decided aggregate tie and may be `null`; `series` separately provides\ntotal/current legs and home/away aggregate scores. `status.period` is the match-period marker;\n`status.stage_id` is a match-phase marker, distinct from `competition.stage_id`.\n\n`start_time`, `end_time`, `updated_at` and `lineups_updated_at` are ISO-8601 UTC timestamps or `null`;\n`start_timestamp` is epoch seconds. `end_time` is the end of the scheduled playing window for a multiday\nfixture, not its actual final-whistle time. `scheduled_days` is the scheduled day count where relevant.\n`live_clock` is nullable and carries `elapsed_ms` in milliseconds elapsed in the current period plus its own\nISO timestamp; use it when supplied instead of parsing the status label. `serving` is `1` home / `2` away on\nracket sports when supplied. `coverage` is a nullable coverage-depth marker and `event_type` a nullable\nevent-type marker (for example singles/doubles). `is_featured` identifies a promoted fixture, `is_hidden` a\nfixture withheld from listings, and nullable `is_active` its active-record flag.\n\n**Venue reference.** Top-level `venue` is a nullable reference containing `venue_id`, `name`, absolute\n`image_url` and companion `image_file`; individual fields can be `null`. Read `/match-info` for city,\ncountry, capacity, neutral-ground status and officials. For the same `match_id` and `sport`, retain this\nreference's ID and artwork when those fields are missing from the detailed information.\n\nUse `has_lineups` as an availability hint and `/match-lineups` for the sheet. Detailed venue and officials are on\n`/match-info`, recent results on `/match-form`, the timeline on `/match-incidents`, and highlighted players on\n`/match-key-players`. `match.media.tv_channels[]` contains name/type/provider, logo URL/file and country\ninclusion/exclusion lists. `audio_streams[]` supplies a stream URL, excluded countries, age restriction and\n`opens_before_seconds` / `closes_after_seconds` relative to kickoff/end, measured in seconds. `live_action[]`\nand `highlights[]` contain type and country restrictions; `stories[]` adds a public story URL, thumbnail\nURL/file and creation-period label. `other_keys[]` names additional media categories without promising decoded\ncontent. Empty collections mean those categories are not supplied; empty country lists mean no\ninclusion/exclusion list is stated, not a guarantee of rights worldwide. Read `/match-media` for video\nplaylists and `/match-social-posts` for posts. Availability hints do not guarantee any particular\nsupplementary dataset is populated.\n\n`partial_errors` is an empty compatibility list on this focused response; it does not describe missing\noptional fields. `locale` can translate available team and competition names; it does not imply every field\nhas a translation.\n\nDiscover `match_id` on `/matches-by-date`, `/live-matches`, competition fixtures or team fixtures. Pair it\nwith the sport that published it; `sport` defaults to `soccer` and is part of the fixture address. An unknown\nfixture or a fixture addressed under the wrong sport returns 404.\n\nThe populated example shows a recorded finished soccer fixture; other sports use the applicable score variants\nabove.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "match": { "match_id": "1793566", "status": { "code": "FT", "label": "Finished", "stage_id": 6, "period": 2, "winner": 2, "aggregate_winner": null }, "home": { "team_id": "2772", "name": "Crystal Palace", "short_name": "Crystal Palace", "abbreviation": "CRY", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/9826.png", "badge_file": "enet/9826.png", "kit_url": "https://storage.livescore.com/images/tshirt/medium/crystal-palace.png", "kit_file": "crystal-palace.png", "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#1B458F", "secondary": "#C4122E" }, "is_national": false, "sport_id": 1, "sport": "soccer", "web_path": "/team/crystal-palace-2021020913320920836-110/", "has_video": true, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": "MCI", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": "https://storage.livescore.com/images/tshirt/medium/manchester-city.png", "kit_file": "manchester-city.png", "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#6CABDD", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": 1, "sport": "soccer", "web_path": "/team/manchester-city-2021020913320920836-104/", "has_video": true, "has_squad": null, "is_placeholder": false }, "home_score": 1, "away_score": 4, "home_score_halftime": 0, "away_score_halftime": 1, "score": { "home": 1, "away": 4, "home_halftime": 0, "away_halftime": 1, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": 1, "away_regulation": 4, "innings": [], "raw": { "Tr1": "1", "Tr2": "4", "Trh1": "0", "Trh2": "1", "Tr1OR": "1", "Tr2OR": "4" } }, "start_time": "2026-08-28T19:00:00.000Z", "start_timestamp": 1787943600, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": "2026-08-28T20:53:37.000Z", "sport_id": 1, "sport": "soccer", "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": "ENG" }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "has_live_tracker": null, "tier_id": null }, "round": "2", "coverage": 0, "event_type": 1, "serving": null, "live_clock": null, "has_lineups": true, "series": null, "media": { "tv_channels": [ { "name": "NOW", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/now.png", "logo_file": "now.png", "countries": [ "IE" ], "excluded_countries": [] }, { "name": "FuboTV", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/fubo.png", "logo_file": "fubo.png", "countries": [ "CA" ], "excluded_countries": [] } ], "audio_streams": [], "live_action": [ { "type": "liveactions", "countries": [], "excluded_countries": [] } ], "stories": [ { "type": "Top Plays", "story_url": "https://stories.fubo.tv/games/6a8f2933b4100174428a666f.html", "thumbnail_url": "https://storage.livescore.com/images/story-highlights-thumbnail/high/e610af07-64a3-400d-aac2-5acebddc9088_0.jpg", "thumbnail_file": "e610af07-64a3-400d-aac2-5acebddc9088_0.jpg", "period": "PRE-GAME", "countries": [], "excluded_countries": [ "TH", "KH" ] }, { "type": "Highlight", "story_url": "https://stories.dazn.com/pt-pt/6a91dbdac61398b307c03a95.html?utm_source=Livescore_Syndication", "thumbnail_url": "https://storage.livescore.com/images/story-highlights-thumbnail/high/c15f082e-c384-4485-a476-7e3033358fd5_0.jpg", "thumbnail_file": "c15f082e-c384-4485-a476-7e3033358fd5_0.jpg", "period": "IN-GAME", "countries": [ "PT" ], "excluded_countries": [] } ], "highlights": [ { "type": "TwitterHighlights", "countries": [ "AU", "ZA" ], "excluded_countries": [] }, { "type": "YoutubeHighlights", "countries": [], "excluded_countries": [] } ], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": false }, "venue": { "venue_id": "580", "name": "Selhurst Park", "image_url": "https://storage.livescore.com/images/venue/high/selhurst-park---crystal-palace.jpg", "image_file": "selhurst-park---crystal-palace.jpg" }, "lineups_updated_at": "2026-08-28T19:07:52.000Z", "partial_errors": [] } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/match-statistics": { "get": { "tags": [ "Match" ], "operationId": "/match-statistics", "description": "Read team statistics, period splits and the shot map for a fixture.", "parameters": [ { "schema": { "type": "string", "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "example": "1793566" }, "required": true, "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "name": "match_id", "in": "query" }, { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" } ], "responses": { "200": { "description": "Read a fixture's team statistics, period splits and shot map. The response contains nullable `match_id` plus\n`teams[]`, `periods[]` and `shots[]`.\n\n**Team and period measures.** `team_side` is `1` home and `2` away, matching `/match-details`. Lines contain\n`fouls`, `throw_ins`, `offsides`, `crosses`, `yellow_cards`, `red_cards`, `second_yellow_red_cards`,\n`shots_on_target`, `shots_off_target`, `shots_woodwork`, `shots_blocked`, `attacks`, `goalkeeper_saves`,\n`goal_kicks`, `counterattacks`, `possession_percent` and `expected_goals`. Counts are numeric; possession is a\npercentage (`28` means 28%) and expected goals is a fractional expected-goal measure. A missing measure is\n`null`, not zero. `periods[]` repeats these measures with its own `period` and `team_side`, ordered by period\nthen side; use those markers rather than array positions. `raw` retains additional numeric recorded measures.\n\n**Shot locations.** Each shot has `team_side`, `period`, nullable `player_id`, the published numeric\n`shot_type` and `x` / `y` pitch coordinates. Coordinates are percentages of the attacking half, with the\norigin at the defending goal line, rather than distances in metres. Preserve the side and period when plotting\nlocations. Outcome-code labels are not supplied here. A non-null `player_id` can open `/player-details`.\n\n**Coverage and emptiness.** The named measures are football-oriented. Recorded soccer fixtures carry\nstatistics where covered, while American-football examples may contain side rows with every named measure\n`null`. Recorded tennis, basketball, cricket and hockey examples can have all three lists empty. Check an\nactual measure rather than only `teams.length`. Shot-map coverage can be narrower than team-statistic\ncoverage. `attacks: 0` has appeared as an unmeasured placeholder, so do not assume it proves no attacks\noccurred.\n\nScheduled and uncovered fixtures can both return empty arrays successfully. This response has no fixture\nstatus; read `/match-details` to distinguish a match awaiting play from one whose statistics are unavailable.\n`match_id` is `null` when no document identity is supplied; retain the ID you requested.\n\nDiscover `match_id` on `/matches-by-date`, `/live-matches`, competition fixtures or team fixtures. Pair it\nwith the sport that published it; `sport` defaults to `soccer` and is part of the fixture address. An unknown\nfixture or a fixture addressed under the wrong sport returns 404.\n\nText localization is not offered; this endpoint does not accept `locale`. The populated recorded example\nabbreviates the period and shot lists for readability; those lists have no count field.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "match_id": "1793566", "teams": [ { "team_side": 1, "fouls": 8, "throw_ins": 12, "offsides": 3, "crosses": 4, "yellow_cards": 1, "red_cards": 0, "second_yellow_red_cards": 0, "shots_on_target": 1, "shots_off_target": 7, "shots_woodwork": 0, "shots_blocked": 1, "attacks": 0, "goalkeeper_saves": 4, "goal_kicks": 5, "possession_percent": 28, "counterattacks": 2, "expected_goals": 0.57, "raw": { "Tnb": 1, "Fls": 8, "Ths": 12, "Ofs": 3, "Crs": 4, "Ycs": 1, "Rcs": 0, "YRcs": 0, "Shof": 7, "Shwd": 0, "Shbl": 1, "Att": 0, "Gks": 4, "Goa": 5, "Pss": 28, "Cos": 2, "Shon": 1, "Xg": 0.57 } }, { "team_side": 2, "fouls": 11, "throw_ins": 19, "offsides": 0, "crosses": 5, "yellow_cards": 2, "red_cards": 0, "second_yellow_red_cards": 0, "shots_on_target": 9, "shots_off_target": 7, "shots_woodwork": 0, "shots_blocked": 2, "attacks": 0, "goalkeeper_saves": 1, "goal_kicks": 6, "possession_percent": 72, "counterattacks": 6, "expected_goals": 1.74, "raw": { "Tnb": 2, "Fls": 11, "Ths": 19, "Ofs": 0, "Crs": 5, "Ycs": 2, "Rcs": 0, "YRcs": 0, "Shof": 7, "Shwd": 0, "Shbl": 2, "Att": 0, "Gks": 1, "Goa": 6, "Pss": 72, "Cos": 6, "Shon": 9, "Xg": 1.74 } } ], "periods": [ { "team_side": 1, "fouls": 4, "throw_ins": 5, "offsides": 2, "crosses": 4, "yellow_cards": 0, "red_cards": 0, "second_yellow_red_cards": 0, "shots_on_target": 1, "shots_off_target": 5, "shots_woodwork": 0, "shots_blocked": 1, "attacks": 0, "goalkeeper_saves": 4, "goal_kicks": 2, "possession_percent": 34, "counterattacks": 2, "expected_goals": 0.31, "raw": { "Tnb": 1, "Fls": 4, "Ths": 5, "Ofs": 2, "Crs": 4, "Ycs": 0, "Rcs": 0, "YRcs": 0, "Shof": 5, "Shwd": 0, "Shbl": 1, "Att": 0, "Gks": 4, "Goa": 2, "Pss": 34, "Cos": 2, "Shon": 1, "Xg": 0.31 }, "period": 1 }, { "team_side": 2, "fouls": 6, "throw_ins": 8, "offsides": 0, "crosses": 2, "yellow_cards": 1, "red_cards": 0, "second_yellow_red_cards": 0, "shots_on_target": 6, "shots_off_target": 5, "shots_woodwork": 0, "shots_blocked": 0, "attacks": 0, "goalkeeper_saves": 1, "goal_kicks": 4, "possession_percent": 66, "counterattacks": 2, "expected_goals": 1.13, "raw": { "Tnb": 2, "Fls": 6, "Ths": 8, "Ofs": 0, "Crs": 2, "Ycs": 1, "Rcs": 0, "YRcs": 0, "Shof": 5, "Shwd": 0, "Shbl": 0, "Att": 0, "Gks": 1, "Goa": 4, "Pss": 66, "Cos": 2, "Shon": 6, "Xg": 1.13 }, "period": 1 } ], "shots": [ { "team_side": 1, "period": 1, "player_id": "31022", "shot_type": 2, "x": 93.5, "y": 65.7 }, { "team_side": 1, "period": 1, "player_id": "15445", "shot_type": 2, "x": 85.9, "y": 68.5 } ] } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/match-lineups": { "get": { "tags": [ "Match" ], "operationId": "/match-lineups", "description": "Read formations, starters, bench, substitutions and unavailable players for each numbered side.", "parameters": [ { "schema": { "type": "string", "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "example": "1793566" }, "required": true, "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "name": "match_id", "in": "query" }, { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read the fixture's team sheets: formation, confirmed starters, bench, coach, unavailable players and\nsubstitutions. The response contains `match_id`, `teams[]`, any sheet `referees[]` and `partial_errors`.\n\n**Join by side.** Each entry's `team_side` is `1` home or `2` away, matching `/match-details`. `team` can be\n`null`; when present it may contain only `team_id` with other identity fields unknown. Use `team_side` to join\nto the requested fixture's home/away objects for names, badges and colors. `formation` is a string such as\n`\"4-2-3-1\"`; `formation_rows` supplies the row sizes with the goalkeeper excluded.\n\n**Player rows.** `starting[]`, `bench[]` and nullable `coach` use the same fields: nullable `player_id`,\n`squad_player_id`, `name`, `first_name`, `last_name`, `slug`, `shirt_number`, `position`, `position_code`,\n`country`, `formation_slot`, `photo_url` and `photo_file`. The formation slot uses `row:column` from the\ngoalkeeper outwards. Read the explicit starter/bench split: soccer starters can have grid slots, basketball\nuses a `STARTER` position marker, and a sport with neither marker can have its whole named squad in `bench`. A\nbench-only squad does not prove that none of those players participated. Position, photos and other identity\nfields can be missing, including on substitution rows; join to the sheet by ID when you need the fuller row.\n\n`player_id` is the ID accepted by `/player-details`. `squad_player_id` belongs to a separate registration\nspace and must not be substituted for it: numerical overlap can resolve to a different player. Basketball and\ncricket sheet captures can have only registration IDs; if `player_id` is `null`, keep the supplied identity\nfor display without manufacturing a player lookup.\n\n**Changes and absences.** `substitutions[]` pairs `player_on` with `player_off_id` and\n`player_off_shirt_number`, plus `minute`, `team_side`, `type_code` and `sequence`; entries are ordered by\nminute. The incoming player row may contain only name, ID and shirt number. `unavailable[]` adds `reason`,\n`reason_code`, free-text `expected_return` and an ISO-8601 UTC `expected_return_date` when supplied. Use the\ndate for sorting; phrases such as `\"Unknown\"` are display text. Coach `country` and sheet referee name/country\nmetadata are conditional.\n\n**Coverage.** Soccer sheets can supply the fullest set of fields; basketball can supply starters and bench\nwithout formation, while cricket can supply a bench-only squad. Other sports and shallow fixture coverage may\nreturn `teams: []`. Teams may appear shortly before kickoff; check `has_lineups` on `/match-details` as a hint\nand retry nearer kickoff when appropriate. It is not a promise of a specific publication time. Missing\nsections and empty `referees` are valid results. Read `/match-info` for venue and officials and\n`/match-key-players` for highlighted players.\n\n`match_id` can be `null` if no sheet identity is supplied. `partial_errors` is an empty compatibility list and\ndoes not explain coverage gaps. `locale` can translate positions, absence descriptions and expected-return\ntext where a translation exists.\n\nDiscover `match_id` on `/matches-by-date`, `/live-matches`, competition fixtures or team fixtures. Pair it\nwith the sport that published it; `sport` defaults to `soccer` and is part of the fixture address. An unknown\nfixture or a fixture addressed under the wrong sport returns 404.\n\nThe populated recorded example abbreviates the player lists and shows missing team identity, which callers\nmust handle.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "match_id": "1793566", "teams": [ { "team_side": 1, "team": null, "formation": "3-4-2-1", "formation_rows": [ 3, 4 ], "starting": [ { "player_id": "27774", "squad_player_id": "27774", "name": "Dean Henderson", "first_name": "Dean", "last_name": "Henderson", "slug": "dean-henderson", "shirt_number": 1, "position": "Goalkeeper", "position_code": 1, "country": null, "formation_slot": "1:1", "photo_url": "https://storage.livescore.com/images/headshots/medium/29125334.png", "photo_file": "29125334.png" }, { "player_id": "94682", "squad_player_id": "94682", "name": "Jaydee Canvot", "first_name": "Jaydee", "last_name": "Canvot", "slug": "jaydee-canvot", "shirt_number": 6, "position": "Defender", "position_code": 2, "country": null, "formation_slot": "2:1", "photo_url": "https://storage.livescore.com/images/headshots/medium/2000187623.png", "photo_file": "2000187623.png" } ], "bench": [ { "player_id": "2654", "squad_player_id": "2654", "name": "Walter Benítez", "first_name": "Walter", "last_name": "Benítez", "slug": "walter-benitez", "shirt_number": 44, "position": "Goalkeeper", "position_code": 5, "country": null, "formation_slot": null, "photo_url": "https://storage.livescore.com/images/headshots/medium/14035968.png", "photo_file": "14035968.png" }, { "player_id": "19422", "squad_player_id": "19422", "name": "Daniel Muñoz", "first_name": "Daniel", "last_name": "Muñoz", "slug": "daniel-munoz", "shirt_number": 2, "position": "Defender", "position_code": 5, "country": null, "formation_slot": null, "photo_url": "https://storage.livescore.com/images/headshots/medium/76050675.png", "photo_file": "76050675.png" } ], "coach": { "player_id": "79791", "squad_player_id": "79791", "name": "Pierre Sage", "first_name": "Pierre", "last_name": "Sage", "slug": "pierre-sage", "shirt_number": null, "position": "COACH", "position_code": 10, "country": "France", "formation_slot": null, "photo_url": null, "photo_file": null }, "unavailable": [ { "player_id": "40912", "squad_player_id": "40912", "name": "Jean-Philippe Mateta", "first_name": "Jean-Philippe", "last_name": "Mateta", "slug": "jean-philippe-mateta", "shirt_number": 14, "position": "Forward", "position_code": 7, "country": null, "formation_slot": null, "photo_url": "https://storage.livescore.com/images/headshots/medium/49034219.png", "photo_file": "49034219.png", "reason": "Hamstring strain", "reason_code": 4, "expected_return": "Unknown", "expected_return_date": null }, { "player_id": "53173", "squad_player_id": "53173", "name": "Chadi Riad", "first_name": "Chadi", "last_name": "Riad", "slug": "chadi-riad", "shirt_number": 4, "position": "Defender", "position_code": 7, "country": null, "formation_slot": null, "photo_url": "https://storage.livescore.com/images/headshots/medium/2000058232.png", "photo_file": "2000058232.png", "reason": "Knee injury", "reason_code": 4, "expected_return": "Unknown", "expected_return_date": null } ], "substitutions": [ { "minute": 63, "team_side": 1, "player_on": { "player_id": "2672", "squad_player_id": null, "name": "Evann Guessand", "first_name": "Evann", "last_name": "Guessand", "slug": "evann-guessand", "shirt_number": 29, "position": null, "position_code": null, "country": null, "formation_slot": null, "photo_url": null, "photo_file": null }, "player_off_id": "9320", "player_off_shirt_number": 22, "type_code": 5, "sequence": 4 }, { "minute": 63, "team_side": 1, "player_on": { "player_id": "9320", "squad_player_id": null, "name": "Joergen Strand Larsen", "first_name": "Jørgen Strand", "last_name": "Larsen", "slug": "jorgen-strand-larsen", "shirt_number": 22, "position": null, "position_code": null, "country": null, "formation_slot": null, "photo_url": null, "photo_file": null }, "player_off_id": "2672", "player_off_shirt_number": 29, "type_code": 4, "sequence": 3 } ] }, { "team_side": 2, "team": null, "formation": "4-2-3-1", "formation_rows": [ 4, 2 ], "starting": [ { "player_id": "2139", "squad_player_id": "2139", "name": "Gianluigi Donnarumma", "first_name": "Gianluigi", "last_name": "Donnarumma", "slug": "gianluigi-donnarumma", "shirt_number": 1, "position": "Goalkeeper", "position_code": 1, "country": null, "formation_slot": "1:1", "photo_url": "https://storage.livescore.com/images/headshots/medium/43252073.png", "photo_file": "43252073.png" }, { "player_id": "63398", "squad_player_id": "63398", "name": "Abdukodir Khusanov", "first_name": "Abdukodir", "last_name": "Khusanov", "slug": "abdukodir-khusanov", "shirt_number": 45, "position": "Defender", "position_code": 2, "country": null, "formation_slot": "2:1", "photo_url": "https://storage.livescore.com/images/headshots/medium/2000168014.png", "photo_file": "2000168014.png" } ], "bench": [ { "player_id": "18508", "squad_player_id": "18508", "name": "Gerónimo Rulli", "first_name": "Gerónimo", "last_name": "Rulli", "slug": "geronimo-rulli", "shirt_number": 28, "position": "Goalkeeper", "position_code": 5, "country": null, "formation_slot": null, "photo_url": "https://storage.livescore.com/images/headshots/medium/14030119.png", "photo_file": "14030119.png" }, { "player_id": "9286", "squad_player_id": "9286", "name": "Rayan Aït-Nouri", "first_name": "Rayan", "last_name": "Aït-Nouri", "slug": "rayan-ait-nouri", "shirt_number": 21, "position": "Defender", "position_code": 5, "country": null, "formation_slot": null, "photo_url": "https://storage.livescore.com/images/headshots/medium/49047581.png", "photo_file": "49047581.png" } ], "coach": { "player_id": "70541", "squad_player_id": "70541", "name": "Enzo Maresca", "first_name": "Enzo", "last_name": "Maresca", "slug": "enzo-maresca", "shirt_number": null, "position": "COACH", "position_code": 10, "country": "Italy", "formation_slot": null, "photo_url": null, "photo_file": null }, "unavailable": [ { "player_id": "2574", "squad_player_id": "2574", "name": "Jérémy Doku", "first_name": "Jérémy", "last_name": "Doku", "slug": "jeremy-doku", "shirt_number": 11, "position": "Forward", "position_code": 7, "country": null, "formation_slot": null, "photo_url": "https://storage.livescore.com/images/headshots/medium/18106083.png", "photo_file": "18106083.png", "reason": "Calf injury", "reason_code": 4, "expected_return": "Unknown", "expected_return_date": null } ], "substitutions": [ { "minute": 75, "team_side": 2, "player_on": { "player_id": "29924", "squad_player_id": null, "name": "Mateo Kovacic", "first_name": "Mateo", "last_name": "Kovačić", "slug": "mateo-kovacic", "shirt_number": 8, "position": null, "position_code": null, "country": null, "formation_slot": null, "photo_url": null, "photo_file": null }, "player_off_id": "28465", "player_off_shirt_number": 24, "type_code": 5, "sequence": 2 }, { "minute": 75, "team_side": 2, "player_on": { "player_id": "28465", "squad_player_id": null, "name": "Josko Gvardiol", "first_name": "Joško", "last_name": "Gvardiol", "slug": "josko-gvardiol", "shirt_number": 24, "position": null, "position_code": null, "country": null, "formation_slot": null, "photo_url": null, "photo_file": null }, "player_off_id": "29924", "player_off_shirt_number": 8, "type_code": 4, "sequence": 1 } ] } ], "referees": [], "partial_errors": [] } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/match-incidents": { "get": { "tags": [ "Match" ], "operationId": "/match-incidents", "description": "Read the fixture timeline: goals, cards and other recorded events, with minute, participants and score.", "parameters": [ { "schema": { "type": "string", "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "example": "1793566" }, "required": true, "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "name": "match_id", "in": "query" }, { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read the fixture's ordered scoring and disciplinary timeline, with its score block, `incidents[]` and\n`incident_count`.\n\n**One scoring event, with its related players.** A goal's scorer is the top-level `player`; the assist belongs\nunder `related_players[]`, which contains incident-shaped records. Keep them attached rather than pairing\nseparate rows by minute. `score_after` is `[home, away]` immediately after an event when supplied, and `null`\non an event without a score change. Use the response's `score` for the recorded overall score, including\napplicable regulation, extra-time/overtime, penalty, set, period and cricket-innings variants.\n\nEach incident carries `period`, `minute`, `elapsed_seconds`, `added_minute`, `team_side` (`1` home / `2`\naway), `type_code`, nullable `type`, nullable `player`, `sequence`, optional `no_penalty` and `reason`. The\nplayer fields are ID, display and split names, slug, shirt number and position/code; only a non-null\n`player_id` addresses `/player-details`. A VAR reason such as `\"VAR:disallowed_offside\"` can carry the\nmeaningful content when no player is named.\n\n`minute` is the published match minute, or the whole minute derived from `elapsed_seconds` where the sport\nsupplies seconds. Seconds preserve the more precise clock; `added_minute` separately records stated stoppage\ntime. Period markers remain the sport's published markers and need not be simple football halves. Incidents\nare ordered by period, minute and `sequence`; use those fields when rendering the timeline rather than sorting\nby player or label.\n\n**Codes and coverage.** Branch on `type_code`; known labels include Goal, Own goal, Assist, Yellow card and\nGoal disallowed (VAR). Unknown meanings retain their numeric code with `type: null`, and missing codes can\nalso be `null`. Commentary has a separate code vocabulary. Soccer scoring/card coverage is the fullest in\nrecorded examples, hockey can carry second-based events, and other sports can return an empty timeline even\nwhen they have a final score. Substitution pairs are available on `/match-lineups`; do not depend on this\ntimeline to supply them.\n\n`incident_count` counts top-level records, excluding the nested related players. A scheduled or uncovered\nfixture can return `incidents: []` and `incident_count: 0` successfully; `/match-details` supplies the fixture\nstatus needed to interpret emptiness. `match_id` can be `null` when no document identity is supplied. `locale`\ncan translate available player names; the named type labels are the API's labels.\n\nDiscover `match_id` on `/matches-by-date`, `/live-matches`, competition fixtures or team fixtures. Pair it\nwith the sport that published it; `sport` defaults to `soccer` and is part of the fixture address. An unknown\nfixture or a fixture addressed under the wrong sport returns 404.\n\nThe recorded populated example is abridged to two incidents; `incident_count: 8` preserves the count from the\nfull response.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "match_id": "1793566", "score": { "home": 1, "away": 4, "home_halftime": 0, "away_halftime": 1, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": 1, "away_regulation": 4, "innings": [], "raw": { "Tr1": "1", "Tr2": "4", "Trh1": "0", "Trh2": "1", "Tr1OR": "1", "Tr2OR": "4" } }, "incidents": [ { "period": 1, "minute": 17, "elapsed_seconds": null, "added_minute": null, "type_code": 36, "type": "Goal", "team_side": 2, "player": { "player_id": "15419", "name": "Erling Haaland", "first_name": "Erling", "last_name": "Haaland", "slug": "erling-haaland", "shirt_number": 9, "position": "Forward", "position_code": 4 }, "score_after": [ 0, 1 ], "related_players": [ { "period": 1, "minute": 17, "elapsed_seconds": null, "added_minute": null, "type_code": 63, "type": "Assist", "team_side": 2, "player": { "player_id": "37399", "name": "Antoine Semenyo", "first_name": "Antoine", "last_name": "Semenyo", "slug": "antoine-semenyo", "shirt_number": 42, "position": "Midfielder", "position_code": 3 }, "score_after": [ 0, 1 ], "related_players": [], "sequence": 2, "no_penalty": null, "reason": null } ], "sequence": 2, "no_penalty": null, "reason": null }, { "period": 1, "minute": 33, "elapsed_seconds": null, "added_minute": null, "type_code": 43, "type": "Yellow card", "team_side": 2, "player": { "player_id": "2307", "name": "Rayan Cherki", "first_name": "Rayan", "last_name": "Cherki", "slug": "rayan-cherki", "shirt_number": 10, "position": "Midfielder", "position_code": 3 }, "score_after": null, "related_players": [], "sequence": 2, "no_penalty": false, "reason": null } ], "incident_count": 8 } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/match-commentary": { "get": { "tags": [ "Match" ], "operationId": "/match-commentary", "description": "Read the covered fixture's written commentary.", "parameters": [ { "schema": { "type": "string", "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "example": "1793566" }, "required": true, "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "name": "match_id", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read the fixture's written passage-of-play commentary, with `match_id`, `language`, nullable `summary`,\n`entries[]` and `entry_count`.\n\n**Newest first.** Entries retain the published newest-first order; read the head for the latest line or\nreverse a copy for a chronological replay. Each row has `text`, nullable `minute` and `added_minute`, plus\n`type_code` and `type` when it marks a labelled event. Ordinary narration often has neither type field. Tennis\nlines can have no minute fields and identify the set/game in the text; preserve the array order for those.\n\nThe commentary code vocabulary differs from `/match-incidents`: `3` Substitution, `10` Kick-off, `11`\nHalf-time, `12` Second half start, `22` Full-time, `36` Goal, `39` Own goal and `43` Yellow card. Further\ncodes retain their number with `type: null`; branch on the code when known and treat labels as a convenience.\n\n`summary.text` is an optional written recap and can contain authored HTML emphasis such as ``.\n`summary.generated_at` is ISO-8601 UTC. A missing recap is `summary: null`; render the entry list\nindependently. `language` identifies the returned text language. `locale` requests available translations of\ncommentary and summary; inspect `language` for the returned language rather than assuming every fixture has\ntranslated coverage.\n\n**Polling and coverage.** Each call returns the available feed in full, without pagination or a since marker.\nNew lines arrive at the head, but entries have no unique entry ID, so callers deduplicating polls must account\nfor repeated text or timing. `entry_count` counts all returned rows in a real response. Scheduled or uncovered\nsupported fixtures may return an empty list, and `match_id` / `language` can be `null` when no commentary\nidentity is supplied. Keep the requested ID as your correlation key.\n\nRecorded coverage is soccer and tennis. Fixtures in basketball, cricket, hockey and American football can\nreturn 404 here even when `/match-details` resolves them; a commentary 404 can therefore mean unsupported\ncoverage rather than a nonexistent fixture. Use `/match-innings` for cricket ball-by-ball scorecard\ncommentary.\n\nThe input is `match_id` and optional `locale`, with no `sport` parameter. Discover IDs on match boards or\nfixture lists and retain the sport to interpret the coverage note. An unknown `match_id` returns 404.\n\nThe recorded populated example keeps two entries for readability; `entry_count: 384` preserves the full\nrecorded count.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "match_id": "1793566", "language": "en", "summary": { "text": "Man City are cruising at 4-1 with only a few minutes of added time left, and they’ve completely smothered this late spell. In the last 15 minutes, City have had 71% possession, the only 2 shots and the only shot on target, while Palace haven’t managed an effort. The big recent blow was Haaland’s second on 84 minutes, finished from Foden’s pass, after Cherki had already starred with two goals. Since then it’s been control and changes, with Bouaddi, Braithwaite and Reis all sent on.", "generated_at": "2026-08-28T20:50:12.000Z" }, "entries": [ { "minute": 90, "added_minute": 6, "text": "Manchester City with a deserved victory after a fine display", "type_code": null, "type": null }, { "minute": 90, "added_minute": 6, "text": "That's it! The referee blows the final whistle", "type_code": 22, "type": "Full-time" } ], "entry_count": 384 } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/match-media": { "get": { "tags": [ "Match" ], "operationId": "/match-media", "description": "Read highlight and clip playlists for a fixture.", "parameters": [ { "schema": { "type": "string", "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "example": "1793566" }, "required": true, "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "name": "match_id", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read video playlists attached to one fixture. The response contains the requested `match_id`, `playlists[]`,\n`video_count` and `partial_errors`. Read `/match-social-posts` for the separate social timeline.\n\nEach playlist has `title`, `type`, `aspect_ratio` and `videos[]`. Titles and types may describe the video host\n(for example `\"YOUTUBE\"`) rather than the fixture. Each video has `video_id`, title, host `stream_id`,\n`thumbnail_url`, ISO-8601 UTC `published_at`, `embeddable` and `type`. A stream ID is an identifier for the\ndeclared host, not a universal playback URL; check `type` and `embeddable` before configuring a player. Images\ncan use the absolute thumbnail URL directly. Missing optional identifiers, artwork and dates stay `null`.\n\n`video_count` is the total videos across the returned playlists, not the number of playlists. There is no\npagination or limit parameter and no promise of one playlist or one clip per fixture. `partial_errors` is an\nempty compatibility list; it does not explain an empty video collection.\n\n**Coverage.** Recorded videos are chiefly soccer highlights, commonly available after the fixture ends.\nLicensing and fixture coverage affect availability; a finished match need not have a video, and other sports\ncan have no playlists. A known fixture with no videos returns 200 with `video_count: 0`; an unknown fixture\nreturns 404. An empty result describes video availability rather than fixture state; use `/match-details` for\nthe score/status.\n\nThe input is `match_id` and optional `locale`, with no `sport` parameter. Discover IDs on match boards or\nfixture lists. `locale` is accepted, but recorded video titles remain as authored and need not translate.\n`match_id` identifies the fixture requested.\n\nThe populated example preserves a recorded playlist and video.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "playlists": [ { "title": "YOUTUBE", "type": "YOUTUBE", "aspect_ratio": "16:9", "videos": [ { "video_id": "zbhmdaUj-PU", "title": "RESUMEN: CRYSTAL PALACE 1-4 MANCHESTER CITY | JORNADA 2 | PREMIER LEAGUE", "stream_id": "zbhmdaUj-PU", "thumbnail_url": "https://i.ytimg.com/vi/zbhmdaUj-PU/mqdefault.jpg", "published_at": "2026-08-28T21:11:34.000Z", "embeddable": true, "type": "Y" } ] } ], "video_count": 1, "match_id": "1793566", "partial_errors": [] } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/match-h2h": { "get": { "tags": [ "Match" ], "operationId": "/match-h2h", "description": "Read the head-to-head record for the sides in a fixture, including published historical meetings and summaries.", "parameters": [ { "schema": { "type": "string", "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "example": "1793566" }, "required": true, "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "name": "match_id", "in": "query" }, { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" }, { "schema": { "type": "integer", "description": "**How many results to return.** Optional; defaults to 10.\nNumber of previous meetings to request, most recent first: 1–50, default 10. This controls one pairing’s history depth, not a page size; there is no offset or next page. Fewer recorded meetings can be returned, and 50 is the largest selectable depth rather than a complete-archive promise.\nAccepts integers from 1 to 50; values outside that range return 400.", "minimum": 1, "maximum": 50 }, "required": false, "description": "**How many results to return.** Optional; defaults to 10.\nNumber of previous meetings to request, most recent first: 1–50, default 10. This controls one pairing’s history depth, not a page size; there is no offset or next page. Fewer recorded meetings can be returned, and 50 is the largest selectable depth rather than a complete-archive promise.\nAccepts integers from 1 to 50; values outside that range return 400.", "name": "limit", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read the previous meetings between the sides of one fixture, most recent first, plus their record over the\nreturned selection. The response contains nullable `match_id`, `matches[]`, `match_count` and `summary[]`.\n\nEach meeting is a match-shaped row: both nullable team identities with IDs, names, abbreviations and badges,\nits competition/country, UTC kickoff, score variants and status/winner marker where supplied. Historic rows\ncan have `match_id: null`; display their recorded fields without offering a match-details link. A non-null row\nID can open `/match-details`, `/match-statistics` or `/match-incidents`, subject to those datasets' coverage.\nBadge and kit fields are conditional; team colors often remain unknown, so use `/match-details` or\n`/team-details` when you need them.\n\n**Depth and summary.** `limit` requests 1–50 meetings, default 10. It selects history depth for one pairing,\nwith no offset or next page; it cannot promise a full rivalry archive. `match_count` counts the selected\nmeetings actually returned. A smaller result can mean the available record is shorter or some rows have no\nusable side identity.\n\nEach summary row contains `team_id`, `team_name`, `wins`, `draws`, `losses` and `played`, counted from the\nmeetings in this response. Identify the record by team ID: its order follows first appearance in the selected\nhistory and is not the requested fixture's home/away order. Winner markers decide the result, so a draw\nsettled on penalties can count as a win rather than a draw. Rows without a recognized result are not counted\nin `played`. Alternate IDs for the same club can also make the two `played` figures differ from each other or\nfrom `match_count`; some retained meetings can name an alternate club identity. Do not require both summary\ncounts to equal the history length.\n\n**Coverage.** Recorded soccer fixtures carry this history; other sports can resolve successfully with\n`matches: []`, `match_count: 0` and `summary: []`. A first meeting or unrecorded pairing can have the same\nempty result. `/match-form` supplies each side's recent results for a preview, with its own coverage limits.\n`locale` can translate available team names. Retain the requested fixture ID if `match_id` is `null`.\n\nDiscover `match_id` on `/matches-by-date`, `/live-matches`, competition fixtures or team fixtures. Pair it\nwith the sport that published it; `sport` defaults to `soccer` and is part of the fixture address. An unknown\nfixture or a fixture addressed under the wrong sport returns 404.\n\nThe recorded populated example abbreviates `matches` to two rows; `match_count: 10` and the summary preserve\nthe full selected response, so the summary does not describe only the two displayed rows.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "match_id": "1793566", "matches": [ { "match_id": "1529123", "status": { "code": "FT", "label": "Finished", "stage_id": 6, "period": 2, "winner": 1, "aggregate_winner": null }, "home": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": "MCI", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/manchester-city-2021020913320920836-104/", "has_video": true, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "2772", "name": "Crystal Palace", "short_name": "Crystal Palace", "abbreviation": "CRY", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/9826.png", "badge_file": "enet/9826.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/crystal-palace-2021020913320920836-110/", "has_video": true, "has_squad": null, "is_placeholder": false }, "home_score": 3, "away_score": 0, "home_score_halftime": null, "away_score_halftime": null, "score": { "home": 3, "away": 0, "home_halftime": null, "away_halftime": null, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": null, "away_regulation": null, "innings": [], "raw": { "Tr1": "3", "Tr2": "0" } }, "start_time": "2026-05-13T19:00:00.000Z", "start_timestamp": 1778698800, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": null, "sport_id": null, "sport": null, "competition": { "competition_id": "1084", "stage_id": "21997", "name": "Premier League 25/26", "short_name": "Premier League", "display_name": "Premier League 25/26", "slug": "premier-league-2025-2026", "competition_slug": "premier-league-2025-2026", "country": { "name": "England", "code": "england", "id": "34", "iso": "ENG" }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": null }, "round": null, "coverage": null, "event_type": null, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [], "audio_streams": [], "live_action": [], "stories": [], "highlights": [], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null }, { "match_id": "1528948", "status": { "code": "FT", "label": "Finished", "stage_id": 6, "period": 2, "winner": 2, "aggregate_winner": null }, "home": { "team_id": "2772", "name": "Crystal Palace", "short_name": "Crystal Palace", "abbreviation": "CRY", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/9826.png", "badge_file": "enet/9826.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/crystal-palace-2021020913320920836-110/", "has_video": true, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": "MCI", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/manchester-city-2021020913320920836-104/", "has_video": true, "has_squad": null, "is_placeholder": false }, "home_score": 0, "away_score": 3, "home_score_halftime": null, "away_score_halftime": null, "score": { "home": 0, "away": 3, "home_halftime": null, "away_halftime": null, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": null, "away_regulation": null, "innings": [], "raw": { "Tr1": "0", "Tr2": "3" } }, "start_time": "2025-12-14T14:00:00.000Z", "start_timestamp": 1765720800, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": null, "sport_id": null, "sport": null, "competition": { "competition_id": "1084", "stage_id": "21997", "name": "Premier League 25/26", "short_name": "Premier League", "display_name": "Premier League 25/26", "slug": "premier-league-2025-2026", "competition_slug": "premier-league-2025-2026", "country": { "name": "England", "code": "england", "id": "34", "iso": "ENG" }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": null }, "round": null, "coverage": null, "event_type": null, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [], "audio_streams": [], "live_action": [], "stories": [], "highlights": [], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null } ], "match_count": 10, "summary": [ { "team_id": "12633", "team_name": "Manchester City", "wins": 6, "draws": 3, "losses": 1, "played": 10 }, { "team_id": "2772", "team_name": "Crystal Palace", "wins": 1, "draws": 3, "losses": 6, "played": 10 } ] } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/match-form": { "get": { "tags": [ "Match" ], "operationId": "/match-form", "description": "Read recent form for both sides of a fixture.", "parameters": [ { "schema": { "type": "string", "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "example": "1793566" }, "required": true, "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "name": "match_id", "in": "query" }, { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" }, { "schema": { "type": "integer", "description": "**How many results to return.** Optional; defaults to 5.\nNumber of recent results to request for each side, most recent first: 1–50, default 5. For example, 10 requests up to ten home-side results and ten away-side results in one response. Each side can return fewer where coverage is shorter; there is no offset or complete-season guarantee.\nAccepts integers from 1 to 50; values outside that range return 400.", "minimum": 1, "maximum": 50 }, "required": false, "description": "**How many results to return.** Optional; defaults to 5.\nNumber of recent results to request for each side, most recent first: 1–50, default 5. For example, 10 requests up to ten home-side results and ten away-side results in one response. Each side can return fewer where coverage is shorter; there is no offset or complete-season guarantee.\nAccepts integers from 1 to 50; values outside that range return 400.", "name": "limit", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read each side's recent results going into a fixture. The response contains nullable `match_id`, `home` and\n`away`; each populated side pairs its team identity with `matches[]`.\n\nA result row carries its own nullable `match_id`, `status` code/label, ISO-8601 UTC `start_time`, home and\naway team objects, final `home_score` / `away_score`, `winner` and nullable competition identity. The winner\nis `1` home, `2` away or `0` draw from that row's perspective; compare the form side's team ID with the row's\nhome/away IDs to derive a W/D/L display. Scores and team names support a useful result description even where\na deep link is unavailable. A non-null result ID can open `/match-details`. Team badge URLs and name variants\nare conditional; colors can be unknown, so read `/team-details` or `/match-details` when required.\n\n`limit` requests 1–50 recent matches **per side**, most recent first, default 5: `limit=10` asks for up to ten\nhome-side results and up to ten away-side results. It controls selection depth rather than pagination; there\nis no offset, and availability can stop below the requested limit. A high limit does not promise a complete\nseason or archive. Lists are not padded to equal lengths.\n\n**Null and empty are different.** A present side can have its `team` filled and `matches: []` when it has no\nrecorded recent results. A missing side section is `null`. Recorded soccer and American-football fixtures can\ncarry form; recorded tennis, basketball, cricket and hockey fixtures can return both sides `null`. Test\n`home?.matches.length` and `away?.matches.length` independently. These are valid coverage results, not\nfailures. `match_id` can be `null` if no document identity is supplied; retain your requested ID.\n\nUse `/match-h2h` for this pairing's previous meetings alongside each side's recent form. `locale` can\ntranslate available team and competition names.\n\nDiscover `match_id` on `/matches-by-date`, `/live-matches`, competition fixtures or team fixtures. Pair it\nwith the sport that published it; `sport` defaults to `soccer` and is part of the fixture address. An unknown\nfixture or a fixture addressed under the wrong sport returns 404.\n\nThe populated recorded example abbreviates each side's result list for readability; this response has no\ntotal-count field.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "match_id": "1793566", "home": { "team": { "team_id": "2772", "name": "Crystal Palace", "short_name": "Crystal Palace", "abbreviation": "CRY", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/9826.png", "badge_file": "enet/9826.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": 1, "sport": "soccer", "web_path": "/team/crystal-palace-2021020913320920836-110/", "has_video": true, "has_squad": null, "is_placeholder": false }, "matches": [ { "match_id": "1902599", "status": { "code": "FT", "label": "Finished" }, "start_time": "2026-10-03T11:30:00.000Z", "home": { "team_id": "2772", "name": "Crystal Palace", "short_name": "Crystal Palace", "abbreviation": "CRY", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/9826.png", "badge_file": "enet/9826.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/crystal-palace-2021020913320920836-110/", "has_video": true, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "3016", "name": "Bristol City", "short_name": "Bristol City", "abbreviation": "BRC", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/8427.png", "badge_file": "enet/8427.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/bristol-city-2022062716001253418-140/", "has_video": true, "has_squad": null, "is_placeholder": false }, "home_score": 0, "away_score": 2, "winner": 2, "competition": { "competition_id": "310", "stage_id": "24129", "name": "Club Friendlies 2026", "short_name": "Club Friendlies 2026", "display_name": "Club Friendlies 2026", "slug": "club-friendlies-2026", "competition_slug": "club-friendlies", "country": { "name": "Club Friendlies", "code": "club-friendlies", "id": "555", "iso": "NON" }, "badge_url": null, "badge_file": null, "color": null, "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": true, "feed_id": "cp:310", "feed_item_ids": [ "cp:310-a:1786198633576", "cp:310-a:1785585188151" ], "has_live_tracker": null, "tier_id": null } }, { "match_id": "1793582", "status": { "code": "FT", "label": "Finished" }, "start_time": "2026-09-20T13:00:00.000Z", "home": { "team_id": "3143", "name": "Leeds United", "short_name": "Leeds United", "abbreviation": "LEE", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/8463.png", "badge_file": "enet/8463.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/leeds-2021020913320920836-83/", "has_video": true, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "2772", "name": "Crystal Palace", "short_name": "Crystal Palace", "abbreviation": "CRY", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/9826.png", "badge_file": "enet/9826.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/crystal-palace-2021020913320920836-110/", "has_video": true, "has_squad": null, "is_placeholder": false }, "home_score": 0, "away_score": 0, "winner": 0, "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": "ENG" }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "has_live_tracker": null, "tier_id": null } } ] }, "away": { "team": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": "MCI", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": 1, "sport": "soccer", "web_path": "/team/manchester-city-2021020913320920836-104/", "has_video": true, "has_squad": null, "is_placeholder": false }, "matches": [ { "match_id": "1793586", "status": { "code": "FT", "label": "Finished" }, "start_time": "2026-09-20T13:00:00.000Z", "home": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": "MCI", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/manchester-city-2021020913320920836-104/", "has_video": true, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "2949", "name": "Sunderland", "short_name": "Sunderland", "abbreviation": "SUN", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/8472.png", "badge_file": "enet/8472.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/sunderland-2022062716001253418-85/", "has_video": true, "has_squad": null, "is_placeholder": false }, "home_score": 5, "away_score": 3, "winner": 1, "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": "ENG" }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "has_live_tracker": null, "tier_id": null } }, { "match_id": "1880923", "status": { "code": "FT", "label": "Finished" }, "start_time": "2026-09-17T18:30:00.000Z", "home": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": "MCI", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/manchester-city-2021020913320920836-104/", "has_video": true, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "2811", "name": "Norwich City", "short_name": "Norwich City", "abbreviation": "NOR", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/9850.png", "badge_file": "enet/9850.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/norwich-2021020913320920836-111/", "has_video": true, "has_squad": null, "is_placeholder": false }, "home_score": 5, "away_score": 0, "winner": 1, "competition": { "competition_id": "1114", "stage_id": "25622", "name": "EFL Cup: Round 3", "short_name": "EFL Cup: Round 3", "display_name": "EFL Cup: Round 3", "slug": "efl-cup-round-3-2025-2026", "competition_slug": "efl-cup-26-27", "country": { "name": "England", "code": "england", "id": "34", "iso": "ENG" }, "badge_url": "https://storage.livescore.com/images/competition/medium/2023-england-efl-cup.png", "badge_file": "2023-england-efl-cup.png", "color": "#B90B2F", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": true, "feed_id": "cp:1114", "feed_item_ids": [ "cp:1114-a:4013823", "cp:1114-a:3984502" ], "has_live_tracker": null, "tier_id": null } } ] } } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/match-standings": { "get": { "tags": [ "Match" ], "operationId": "/match-standings", "description": "Read the standings rows published for the sides of a fixture.", "parameters": [ { "schema": { "type": "string", "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "example": "1793566" }, "required": true, "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "name": "match_id", "in": "query" }, { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read the league-table context for the two sides of a fixture, addressed by its match ID. This fixture-scoped\nresult is usually a mini-table containing the sides' own ranked rows. Use `/standings` with `competition_id`\nfor competition-wide standings, or `/competition-draw` for a cup bracket.\n\nThe response contains nullable `competition`, `groups[]` and `row_count`. Competition identity can describe\nthe fixture's stage or group rather than just the parent league; use its `competition_id` and `stage_id`\naccording to their separate address spaces. Each group has nullable `name`, `stage_id` and `tables[]`. Each\ntable has nullable `name`, `table_type`, decoded `table_scope` (`overall`, `home`, `away` or `form`),\n`rows[]`, `zones[]`, `table_marker_ids[]` and `table_notes[]`. Do not rely on a universal group or table\ncount.\n\n**Row fields.** Each row carries its real `rank`, team ID/names, badge URL/file and kit URL; `played`, `won`,\n`drawn`, `lost`, `goals_for`, `goals_against`, `goal_difference`, `points`, `adjustment`; and sport-specific\nregulation/overtime/penalty win/loss splits, `points_for`, `points_against` and `win_percentage` where\npublished. Win percentage is a fraction (`0.5` means 50%), not an integer percentage. Missing measures are\n`null`; an adjustment of zero is a real unadjusted value. Football's unused points-scoring columns can read\nzero; do not confuse them with goals. `external_reference_id` is a separate team-reference ID, not the\n`team_id` accepted by team endpoints.\n\n`row_count` totals rows across the returned groups and table variants, not league size or distinct-team count.\nRows remain in table order, which need not match the fixture's home/away order; join by `team_id`.\n\n**Bands and notes.** Row `zone_ids` refer to table `zones[]`. Each zone gives `zone_id`, member `ranks`,\n`row_count`, label, `color` (`#RRGGBB`) and `localization_key` where known. Bands can be noncontiguous and a\nrank can have several markers. Table `table_marker_ids` use a different vocabulary and resolve through\n`table_notes[]` (`note_id`, text, localization key), not through row zones. Resolved labels/colors/notes may\nbe absent while numeric IDs remain useful. `/table-legend` supplies the vocabulary and `/translations` can\nresolve localization keys. A mini-table can have few or no zones yet still have table notes.\n\n`form[]` on a row contains recent `match_id` / numeric `result` pairs when the table has form coverage;\noverall tables commonly have empty form lists. Use `/match-form`, or read `/league-table` and select a\nreturned table whose `table_scope` is `form`, rather than assuming this miniature table has recent results.\n\nA cup tie, friendly, knockout round or uncovered fixture can succeed with `row_count: 0` and `groups: []`. An\nempty result is not a league position of zero. `locale` can translate available competition/team names; legend\nlabels retain their supplied language and expose translation keys.\n\nDiscover `match_id` on `/matches-by-date`, `/live-matches`, competition fixtures or team fixtures. Pair it\nwith the sport that published it; `sport` defaults to `soccer` and is part of the fixture address. An unknown\nfixture or a fixture addressed under the wrong sport returns 404.\n\nThe populated recorded example preserves the fixture's two-row table; its row count is the returned extract\nsize.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": "ENG" }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "has_live_tracker": null, "tier_id": null }, "groups": [ { "name": "Premier League", "stage_id": "25545", "tables": [ { "name": null, "table_type": 1, "table_scope": "overall", "rows": [ { "rank": 1, "team_id": "12633", "team_name": "Manchester City", "team_short_name": "Man City", "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": "https://storage.livescore.com/images/team-kit-home/medium/8456.png", "played": 5, "won": 5, "drawn": 0, "lost": 0, "goals_for": 13, "goals_against": 5, "goal_difference": 8, "points": 15, "won_regulation": 5, "won_overtime": 0, "won_penalties": 0, "lost_regulation": 0, "lost_overtime": 0, "lost_penalties": 0, "points_for": 0, "points_against": 0, "adjustment": 0, "win_percentage": null, "zone_ids": [ 20 ], "external_reference_id": "SBTP_2_1000000139", "form": [] }, { "rank": 15, "team_id": "2772", "team_name": "Crystal Palace", "team_short_name": "Crystal Palace", "badge_url": "https://storage.livescore.com/images/team/medium/enet/9826.png", "badge_file": "enet/9826.png", "kit_url": "https://storage.livescore.com/images/team-kit-home/medium/9826.png", "played": 5, "won": 1, "drawn": 1, "lost": 3, "goals_for": 6, "goals_against": 11, "goal_difference": -5, "points": 4, "won_regulation": 1, "won_overtime": 0, "won_penalties": 0, "lost_regulation": 3, "lost_overtime": 0, "lost_penalties": 0, "points_for": 0, "points_against": 0, "adjustment": 0, "win_percentage": null, "zone_ids": [], "external_reference_id": "SBTP_2_1000013415", "form": [] } ], "zones": [ { "zone_id": 20, "ranks": [ 1 ], "row_count": 1, "label": "Champions League", "color": "#0075FF", "localization_key": "@phase_champ_league" } ], "table_marker_ids": [ 150, 211 ], "table_notes": [ { "note_id": 150, "text": "Cup winner qualifies for European competition.", "localization_key": "@phase_info_european_comp" }, { "note_id": 211, "text": "League cup gives UEFA Europa Conference League qualification.", "localization_key": "@phase_info_europa_conf_league_qual" } ] } ] } ], "row_count": 2 } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/match-insights": { "get": { "tags": [ "Match" ], "operationId": "/match-insights", "description": "Read the fixture's short editorial statistical talking points.", "parameters": [ { "schema": { "type": "string", "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset.", "example": "1696608" }, "required": true, "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset.", "name": "match_id", "in": "query" }, { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" } ], "responses": { "200": { "description": "Read the fixture's short statistical talking points. The response contains nullable `match_id`,\n`key_statistics[]` and `partial_errors`. The longer written editorial verdict has its own endpoint,\n`/match-verdict`.\n\nEach talking point carries `insight_id`, its written `text`, nullable `topic`, `topic_display` and `topic_id`.\nGroup or filter by topic for preview panels; `topic_display` is the presentation form of an angle such as\nMatch Result, Correct Score or Both Teams to Score. Decimal values in display topics appear as ordinary\ndecimal points. IDs identify the published insight/topic and are not player, team or fixture IDs.\n\n**Selective, time-sensitive coverage.** Recorded coverage is chiefly soccer previews. Talking points can\nappear shortly before kickoff and later disappear, including after a match finishes; they are not a permanent\nhistorical-statistics archive. Uncovered fixtures and other sports can return an empty list successfully. No\nparticular number of talking points or preview publication window is guaranteed. Form and head-to-head on\n`/match-form` and `/match-h2h` provide alternative preview material where those datasets are covered.\n\n`match_id` can be `null` when no insight identity is supplied, so keep your requested match ID even with a\npopulated or empty list. `partial_errors` is an empty compatibility list and is not a signal explaining absent\neditorial coverage. Text localization is not offered and `locale` is not accepted.\n\nDiscover `match_id` on `/matches-by-date`, `/live-matches`, competition fixtures or team fixtures. Pair it\nwith the sport that published it; `sport` defaults to `soccer` and is part of the fixture address. An unknown\nfixture or a fixture addressed under the wrong sport returns 404.\n\nThe populated example is a historical recorded capture for `1696608`, retained to show the current\ntalking-point fields. That preview may now be empty; the example is not a promise of current editorial\navailability.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "match_id": "1696608", "key_statistics": [ { "insight_id": "4c97d6f0-eb1f-4312-93a5-5cbc14b21165", "text": "No MLS team has found the net in more games this season than LA Galaxy's total of 20", "topic": "Match Result and Both Teams to Score", "topic_display": "RESULT AND BOTH TEAMS TO SCORE", "topic_id": "d345b5ec-1320-48fa-9be8-85c79afbb6e3" }, { "insight_id": "5372a178-bc0a-4688-a594-50459baf4036", "text": "Vancouver Whitecaps have been winners in three of their last four MLS games", "topic": "Match Result", "topic_display": "MATCH RESULT", "topic_id": "a319c3d5-61f0-4642-862f-af31e386e1b8" }, { "insight_id": "56c1e1fa-0aaf-4368-a4c1-a74a83196d94", "text": "All of Vancouver Whitecaps' four MLS defeats this season have been by a single goal", "topic": "Correct Score", "topic_display": "CORRECT SCORE", "topic_id": "351f699d-97d4-4f38-90d9-996b5bec6da4" }, { "insight_id": "7cdd52bf-c03e-48d5-b214-7204066b4439", "text": "No team has scored in more of their MLS games than LA Galaxy have this season (20 in 23)", "topic": "Over or Under 3.5 Goals", "topic_display": "OVER OR UNDER 3.5 GOALS", "topic_id": "09b2acf9-0408-4e42-9d8b-bdf8c37ae3a0" }, { "insight_id": "e1d46f54-bc1a-4573-ad19-25d27e45e083", "text": "These sides drew 1-1 last time they met but ten of the previous 12 MLS meetings were overs", "topic": "Over or Under 2.5 Goals", "topic_display": "OVER OR UNDER 2.5 GOALS", "topic_id": "5c8079e8-d19e-4478-a9b0-cb19aa59c305" }, { "insight_id": "fa4e35d4-1fd7-4162-8375-39aaae8e73c8", "text": "LA Galaxy lost and there were four goals or more in their last MLS game two weeks ago", "topic": "Match Result and 4 or More Goals", "topic_display": "RESULT AND 4 OR MORE GOALS", "topic_id": "1a5a61b2-06d7-4786-9153-6409eb6e8a28" } ], "partial_errors": [] } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/match-innings": { "get": { "tags": [ "Match" ], "operationId": "/match-innings", "description": "Read a cricket fixture's innings scorecards, batting and bowling figures, wicket falls and over-by-over details where covered.", "parameters": [ { "schema": { "type": "string", "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset.", "example": "1772643" }, "required": true, "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset.", "name": "match_id", "in": "query" }, { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "cricket" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" } ], "responses": { "200": { "description": "Read the innings scorecards for a cricket fixture: totals, batting, bowling, wicket falls, overs and\nball-by-ball commentary. The response contains nullable `match_id`, `innings[]`, `innings_count`,\n`participants[]` and `participant_count`.\n\n**Innings and units.** Each card has `title`, `innings`, `team_number`, `runs`, `wickets`, `overs`, `run_rate`\nand an `extras` block containing `total`, `byes`, `leg_byes`, `no_balls`, `wides` and `penalty`. The innings\nnumber is within that side's count, so a multi-innings match can read `1, 1, 2, 2`; use `team_number` and\ntitle to distinguish the sides. Preserve the listed card order. Overs and ball positions use cricket notation:\n`14.5` means 14 completed overs and five balls, not 14.5 decimal overs. Run rate and economy are runs per\nover; strike rate is runs per 100 balls.\n\n- `batting[]` lists the batter's `player_id` / resolved name, `batted`, `out`, runs, balls faced, fours,\n sixes, strike rate, dismissal text and `dismissal_raw` / numeric `dismissal_code`, plus bowler/fielder IDs\n and names. A player who did not bat can have `null` counts: do not turn them into a duck. Dismissal text can\n retain `[B]` or `[F]` if an identity is missing; use the stated flags and text together when displaying\n incomplete coverage.\n- `bowling[]` lists player ID/name, overs, maidens, runs conceded, wickets, no balls, wides and economy.\n- `fall_of_wickets[]` gives wicket `order`, batter/bowler identities, team `score`, `over` and commentary.\n- `over_by_over[]` gives the over number, bowler name, runs/wickets during the over, nullable end score and\n `balls[]` outcome strings such as `\"W\"` and `\"4\"`. Preserve the supplied order, commonly newest first.\n- `commentary[]` gives `over`, written `text` and nullable `state` such as Wicket or End of over, in the\n supplied order.\n\n**Participants and addressing.** `participants[]` contains player IDs, display/split names, nullable\n`squad_player_id` and `slug`. Scorecard batter, bowler and fielder IDs refer to these participants; absent or\nno-player IDs stay `null`. Use these IDs to join the card to its participants. Player-profile availability\nand ID compatibility are separate and should not be assumed for a scorecard participant. Never substitute a\nregistration `squad_player_id` for an athlete ID. Cricket participants can leave registration IDs and slugs unset.\n\n`innings_count` and `participant_count` count their respective returned arrays in a real response. A scheduled\ncricket fixture may name participants before it has any innings, or have neither yet. Other sports return\nempty innings but may still supply participant squads, including soccer and basketball; an empty scorecard\nbeside a non-empty participant list is valid. Pass `sport=cricket` for cricket cards. `match_id` can be `null`\nwhen no document identity is supplied; retain your requested ID.\n\nDiscover `match_id` on `/matches-by-date`, `/live-matches`, competition fixtures or team fixtures. Pair it\nwith the sport that published it; `sport` defaults to `soccer` and is part of the fixture address. An unknown\nfixture or a fixture addressed under the wrong sport returns 404.\n\nText localization is not offered; `locale` is not accepted. Use `/match-details` for fixture status/result and\nconcise innings scores. The populated recorded example abbreviates batting, bowling, wicket, over, commentary\nand participant lists; `innings_count: 2` and `participant_count: 22` preserve the full recorded counts.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "match_id": "1772643", "innings": [ { "innings": 1, "title": "BTR 1ST INN", "team_number": 2, "runs": 127, "wickets": 9, "overs": 20, "run_rate": 6.35, "extras": { "total": 5, "byes": 1, "leg_byes": 1, "no_balls": 0, "wides": 3, "penalty": 0 }, "batting": [ { "player_id": "20760", "name": "Zachary Carter", "batted": true, "out": true, "runs": 28, "balls_faced": 27, "fours": 0, "sixes": 3, "strike_rate": 103.7, "dismissal": "c Alex Hales b Usman Tariq", "dismissal_raw": "c [F] b [B]", "dismissal_code": 25, "bowler_id": "18503", "bowler_name": "Usman Tariq", "fielder_id": "4150", "fielder_name": "Alex Hales" }, { "player_id": "21697", "name": "Shian Brathwaite", "batted": true, "out": true, "runs": 13, "balls_faced": 15, "fours": 1, "sixes": 1, "strike_rate": 86.67, "dismissal": "c Matthew Tromp b Sunil Narine", "dismissal_raw": "c [F] b [B]", "dismissal_code": 25, "bowler_id": "4956", "bowler_name": "Sunil Narine", "fielder_id": "17339", "fielder_name": "Matthew Tromp" } ], "bowling": [ { "player_id": "4956", "name": "Sunil Narine", "overs": 4, "maidens": 0, "runs_conceded": 14, "wickets": 2, "no_balls": 0, "wides": 0, "economy": 3.5 }, { "player_id": "5680", "name": "Akeal Hosein", "overs": 3, "maidens": 0, "runs_conceded": 27, "wickets": 1, "no_balls": 0, "wides": 0, "economy": 9 } ], "fall_of_wickets": [ { "order": 1, "player_id": "21697", "name": "Shian Brathwaite", "bowler_id": "4956", "bowler_name": "Sunil Narine", "score": 25, "over": 4.2, "commentary": "OUT! Caught. Sunil Narine to Shian Brathwaite. Carrom ball back of a length, off stump on the back foot pulling, mis-timed in the air uncontrolled to deep square leg, caught by Tromp. Early setback for Barbados Tridents." }, { "order": 2, "player_id": "5648", "name": "Quinton de Kock", "bowler_id": "8346", "bowler_name": "Jyd Goolie", "score": 38, "over": 8.1, "commentary": "OUT! Caught. Jyd Goolie to Quinton de Kock. Off break length ball, outside off stump on the front foot sweeping, top edge in the air uncontrolled to backward square leg, caught by Tariq." } ], "over_by_over": [ { "over": 20, "bowler_name": "Kieron Pollard", "runs": 13, "wickets": 2, "score": "127/9", "balls": [ "W", "3" ] }, { "over": 19, "bowler_name": "Akeal Hosein", "runs": 10, "wickets": 1, "score": "114/7", "balls": [ "W", "0" ] } ], "commentary": [ { "over": 20, "text": "Over 20. 13 runs. Bowler: Kieron Pollard. Barbados Tridents: 127/9(rr 6.35)", "state": "End of over" }, { "over": 19.6, "text": "OUT! Run Out. Kieron Pollard to Rivaldo Clarke. Off cutter short, wide outside off stump on the back foot cutting, mis-timed to point for 2 runs, fielded by Tariq, by Pooran, mis-fielded by Hosein. The Barbados Tridents finish a challenging innings on 127/9, with the wickets falling at regular intervals struggling to build any momentum, against TKR's quality spinners. Zachary Carter top-scored with 28, while Chris Green provided a late spark with a quick cameo. Rivaldo Clarke's unbeaten 15 off seven deliveries gave Barbados some valuable runs at the death. For Trinbago Knight Riders, Sunil Narine and Kieron Pollard led the bowling attack with two wickets each. Trinbago now need 128 runs to win. Let's get ready for the chase.", "state": "Wicket" } ] }, { "innings": 1, "title": "TKR 1ST INN", "team_number": 1, "runs": 128, "wickets": 3, "overs": 14.5, "run_rate": 8.62, "extras": { "total": 6, "byes": 1, "leg_byes": 2, "no_balls": 0, "wides": 3, "penalty": 0 }, "batting": [ { "player_id": "5160", "name": "Colin Munro", "batted": true, "out": true, "runs": 37, "balls_faced": 26, "fours": 5, "sixes": 1, "strike_rate": 142.31, "dismissal": "c Rivaldo Clarke b Chris Green", "dismissal_raw": "c [F] b [B]", "dismissal_code": 25, "bowler_id": "7532", "bowler_name": "Chris Green", "fielder_id": "14855", "fielder_name": "Rivaldo Clarke" }, { "player_id": "4956", "name": "Sunil Narine", "batted": true, "out": true, "runs": 55, "balls_faced": 33, "fours": 1, "sixes": 6, "strike_rate": 166.67, "dismissal": "c Rivaldo Clarke b Ramon Simmonds", "dismissal_raw": "c [F] b [B]", "dismissal_code": 25, "bowler_id": "13094", "bowler_name": "Ramon Simmonds", "fielder_id": "14855", "fielder_name": "Rivaldo Clarke" } ], "bowling": [ { "player_id": "11484", "name": "Mujeeb Ur Rahman", "overs": 4, "maidens": 0, "runs_conceded": 39, "wickets": 1, "no_balls": 0, "wides": 0, "economy": 9.75 }, { "player_id": "7532", "name": "Chris Green", "overs": 4, "maidens": 0, "runs_conceded": 20, "wickets": 1, "no_balls": 0, "wides": 0, "economy": 5 } ], "fall_of_wickets": [ { "order": 1, "player_id": "5160", "name": "Colin Munro", "bowler_id": "7532", "bowler_name": "Chris Green", "score": 96, "over": 9.3, "commentary": "OUT! Caught. Chris Green to Colin Munro. Off break length ball, off stump on the front foot Slog, mis-timed in the air uncontrolled to long on, caught by Clarke. Finally, Green breaks the partnership." }, { "order": 2, "player_id": "4956", "name": "Sunil Narine", "bowler_id": "13094", "bowler_name": "Ramon Simmonds", "score": 102, "over": 10.5, "commentary": "OUT! Caught. Ramon Simmonds to Sunil Narine. Slower ball back of a length, wide outside off stump on the back foot pulling, mis-timed in the air uncontrolled to long on, caught by Clarke. An excellent knock comes to an end." } ], "over_by_over": [ { "over": 15, "bowler_name": "Ramon Simmonds", "runs": 9, "wickets": 0, "score": null, "balls": [ "1", "4" ] }, { "over": 14, "bowler_name": "Mujeeb Ur Rahman", "runs": 5, "wickets": 0, "score": "119/3", "balls": [ "0", "1" ] } ], "commentary": [ { "over": 15, "text": "Over 15. 9 runs. Bowler: Ramon Simmonds. Trinbago Knight Riders: 128/3(rr 8.53)", "state": null }, { "over": 14.5, "text": "Ramon Simmonds to Kieron Pollard. Length ball, down leg side on the front foot flick, Played to long on for 2 runs. The Trinbago Knight Riders chased down the target with ease, completing a comfortable victory. Their openers got off to a blistering start, putting the pressure firmly on the Barbados Tridents bowlers from the outset. Sunil Narine led the charge with a powerful 55, while Colin Munro made a valuable contribution to keep the chase on track. Barbados tried hard to defend the modest total, but their bowlers struggled to contain the Knight Riders' aggressive batting. Sunil Narine is the Player of the Match.", "state": "Two runs" } ] } ], "innings_count": 2, "participants": [ { "player_id": "5160", "squad_player_id": null, "name": "Colin Munro", "first_name": "Colin", "last_name": "Munro", "slug": null }, { "player_id": "4150", "squad_player_id": null, "name": "Alex Hales", "first_name": "Alexander", "last_name": "Hales", "slug": null } ], "participant_count": 22 } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/match-info": { "get": { "tags": [ "Match" ], "operationId": "/match-info", "description": "Read a fixture's venue, city, capacity, officials and information-specific kickoff time.", "parameters": [ { "schema": { "type": "string", "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "example": "1793566" }, "required": true, "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "name": "match_id", "in": "query" }, { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read the fixture's venue and match officials, with `match_id` and an information-specific `start_time`. Use\n`/match-details` for score, status and the scoreboard kickoff time.\n\n`start_time` is ISO-8601 UTC or `null`. The nullable `venue` object contains `venue_id`, `name`, `city`,\n`country`, `capacity` in spectators, `is_neutral`, absolute `image_url` and companion `image_file`. Venue\nidentity or artwork may be missing even when its name/city is known. Empty information can also appear as a\nvenue-shaped object with unknown fields; test the fields you display rather than requiring a venue ID.\nFor the same `match_id` and `sport`, `/match-details` can supply a shallow venue reference with ID and\nartwork. Use its non-null fields when the corresponding information fields are missing; keep city, country,\ncapacity and neutral-ground status from this response.\n\n`referees[]` contains official `name`, `country`, `country_id` and `is_known`. The country ID is a country\nreference, not a referee/player ID, and `is_known` is the published recognition flag. The list can be empty\neven when venue details are available; neither completeness nor an official count is guaranteed.\n\n`match_id` identifies the fixture requested. Venue fields can be `null`, flags can be false, and officials can\nbe empty as valid coverage results. `locale` can translate available names or descriptions; it does not\nguarantee a translated venue or official name.\n\nDiscover `match_id` on `/matches-by-date`, `/live-matches`, competition fixtures or team fixtures. Pair it\nwith the sport that published it; `sport` defaults to `soccer` and is part of the fixture address. An unknown\nfixture or a fixture addressed under the wrong sport returns 404.\n\nThe populated recorded example shows a soccer venue, capacity and official; missing artwork/venue ID remain\nexplicit.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "match_id": "1793566", "start_time": "2026-08-28T19:00:00.000Z", "venue": { "venue_id": null, "name": "Selhurst Park", "city": "London", "country": "England", "capacity": 25149, "is_neutral": false, "image_url": null, "image_file": null }, "referees": [ { "name": "Andy Madley", "country": "England", "country_id": "2", "is_known": false } ] } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/match-key-players": { "get": { "tags": [ "Match" ], "operationId": "/match-key-players", "description": "Read the highlighted players and figures for the sides in a fixture.", "parameters": [ { "schema": { "type": "string", "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "example": "1793566" }, "required": true, "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "name": "match_id", "in": "query" }, { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read the highlighted players and figures for the sides of the requested fixture. The response contains the\nrequested `match_id` and `teams[]`; each side carries `team_side`, nullable `team` and `key_players[]`.\n\n`team_side` is `1` home or `2` away. Identify a side by this marker and the available `team_id`. A `team`\nmay be `null` or supply only\n`team_id` with other fields unknown; join `team_side` to `/match-details` for the requested fixture's team\nidentity when needed. `match_id` always identifies the fixture requested, including when the collection is\nempty.\n\nEach highlighted player has nullable `player_id`, `first_name`, `last_name`, `name`, numeric `stat_code` and\nstring `value`. Only a non-null player ID addresses `/player-details`. `stat_code` retains its published\nnumber because a complete label vocabulary is unavailable; do not assign guessed metric labels or units to it.\n`value` is display text, not a guaranteed numeric measurement.\n\nCoverage is selective and chiefly soccer in recorded examples. A side can have an empty key-player list,\nmissing team metadata, or no side entry; other sports or uncovered fixtures can return `teams: []`\nsuccessfully. Highlighted players are separate from confirmed starters and should not be treated as a team\nsheet. Read `/match-lineups` for starters, bench, substitutions and unavailable players. `locale` can\ntranslate available identity fields; numeric codes and authored display values need not change.\n\nDiscover `match_id` on `/matches-by-date`, `/live-matches`, competition fixtures or team fixtures. Pair it\nwith the sport that published it; `sport` defaults to `soccer` and is part of the fixture address. An unknown\nfixture or a fixture addressed under the wrong sport returns 404.\n\nThe populated recorded example abbreviates each side's highlighted-player list and preserves team identities\nmatched by ID.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "teams": [ { "team_side": 1, "team": { "team_id": "2772", "name": "Crystal Palace", "short_name": "Crystal Palace", "abbreviation": "CRY", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/9826.png", "badge_file": "enet/9826.png", "kit_url": "https://storage.livescore.com/images/team-kit-cup2/medium/9826.png", "kit_file": "team-kit-cup2/medium/9826.png", "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "key_players": [ { "player_id": "32357", "first_name": "Tyrick", "last_name": "Mitchell", "name": "Tyrick Mitchell", "stat_code": 0, "value": "2" }, { "player_id": "15445", "first_name": "Daichi", "last_name": "Kamada", "name": "Daichi Kamada", "stat_code": 1, "value": "3" } ] }, { "team_side": 2, "team": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": "MCI", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": "https://storage.livescore.com/images/team-kit-home/medium/8456.png", "kit_file": "team-kit-home/medium/8456.png", "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "key_players": [ { "player_id": "15419", "first_name": "Erling", "last_name": "Haaland", "name": "Erling Haaland", "stat_code": 0, "value": "5" }, { "player_id": "37399", "first_name": "Antoine", "last_name": "Semenyo", "name": "Antoine Semenyo", "stat_code": 1, "value": "3" } ] } ], "match_id": "1793566" } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/match-verdict": { "get": { "tags": [ "Match" ], "operationId": "/match-verdict", "description": "Read the fixture's written editorial verdict and selected outcome where available.", "parameters": [ { "schema": { "type": "string", "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "example": "1793566" }, "required": true, "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "name": "match_id", "in": "query" }, { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" } ], "responses": { "200": { "description": "Read the fixture's written editorial verdict and selected outcome where available. The response contains the\nrequested `match_id` and `verdicts[]`. Short statistical talking points are on `/match-insights`.\n\nEach verdict has `verdict_id`, written `text`, `language`, `is_primary` and nullable `selection`. The primary\nflag identifies a headline write-up when several are published; do not assume exactly one verdict or a fixed\nlanguage. `selection`, when present, carries `name`, `display_name`, `selection_id`, `topic`, `topic_display`\nand `topic_id`. Display names use ordinary decimal points. Those IDs refer to the editorial outcome/topic and\nare not fixture, team or player IDs. A missing selection does not invalidate the written text.\n\n**Selective, time-sensitive coverage.** A known fixture can have no verdict, and preview material can\ndisappear after the match. An empty `verdicts` list is a valid response; a populated insights list does not\nguarantee a verdict. Recorded editorial coverage is chiefly soccer. `match_id` always identifies the fixture\nrequested, including when no verdict is available. Text localization is not offered and this endpoint does not\naccept `locale`; use the returned `language` when displaying a verdict.\n\nDiscover `match_id` on `/matches-by-date`, `/live-matches`, competition fixtures or team fixtures. Pair it\nwith the sport that published it; `sport` defaults to `soccer` and is part of the fixture address. An unknown\nfixture or a fixture addressed under the wrong sport returns 404.\n\nThe example is an actual empty capture. It demonstrates valid absence of coverage; there is no verified\npopulated verdict capture represented here.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "verdicts": [], "match_id": "1793566" } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/match-social-posts": { "get": { "tags": [ "Match" ], "operationId": "/match-social-posts", "description": "Read social posts attached to a fixture, with authors, published text and public links.", "parameters": [ { "schema": { "type": "string", "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "example": "1793566" }, "required": true, "description": "**The fixture to read.** Required numeric identifier, sent as text.\n\nGet `match_id` from `/matches-by-date`, `/live-matches`, `/matches-by-team`, a competition schedule or `/day-coverage`. The coverage directory supplies IDs without full fixture rows.\nUse the same ID across focused match routes, carrying the fixture's `sport` where accepted. Optional statistics, commentary, lineups, editorial or media coverage can differ for the same fixture; an ID alone does not promise every dataset. Unknown fixtures return 404 on addressed match reads; valid fixtures may have no optional coverage.", "name": "match_id", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read social posts attached to a fixture. The response contains the requested `match_id`, `posts[]` and\nnullable `post_total_count`. Read `/match-media` for video playlists.\n\nEach post has nullable `post_id`, authored `text`, public `url`, `type`, ISO-8601 UTC `published_at`, nullable\n`author`, `media[]`, nullable `metrics` and `referenced_post_ids[]`. A repost can have `text: null`; show its\npublic link or referenced IDs rather than assuming every row contains a standalone message. The conversation\ncan include general posts from related teams/accounts, not only descriptions of play.\n\n`author` contains `author_id`, display `name`, `handle`, `avatar_url`, `profile_url`, `is_verified` and\nnullable `follower_count`. These are social-account IDs, separate from sports-entity IDs. Attached media has\n`type`, public `url`, `preview_url`, `width` and `height` in pixels when supplied. Metrics contain `likes` and\n`reposts` if available; recorded captures can leave metrics and follower counts entirely `null`, so do not\ntreat them as zero or rely on them for ranking reach/engagement. Referenced IDs identify other social posts\nrather than fixtures.\n\n**Totals and availability.** `post_total_count` is the published conversation total when available, not\n`posts.length`; it can exceed the returned slice. There is no limit, offset or next-page parameter, so the\ntotal is not a traversable archive promise and need not be an exact lifetime total. Preserve the returned post\norder. `posts: []` is valid for a known fixture, including older or uncovered events, while an unknown fixture\nreturns 404. Recorded coverage is chiefly soccer and can change around the event.\n\nThe input is `match_id` and optional `locale`, with no `sport` parameter. Discover IDs on match boards or\nfixture lists. `locale` is accepted but recorded post text remains as authored; it does not promise\ntranslation. `match_id` always identifies the fixture requested.\n\nThe populated example is a historical recorded social capture for `1793566`, aligned with this endpoint's\ncurrent fields. It keeps three posts for readability\nand preserves `post_total_count: 100`; that total describes the recorded conversation, not the three displayed\nrows or current availability.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "posts": [ { "post_id": "2093617149193670668", "text": "Watch our Under-18s take on Leeds, LIVE on CITY+ from 12:00 (UK) 📺\n\n🔗 bit.ly/MCILEEU18PL", "url": "https://x.com/ManCity/status/2093617149193670668", "type": "DEFAULT", "published_at": "2026-08-29T08:30:00.000Z", "author": { "author_id": "14573900", "name": "Manchester City", "handle": "ManCity", "avatar_url": "https://pbs.twimg.com/profile_images/1988659455366500352/RbDXMQEB_normal.jpg", "profile_url": "https://x.com/ManCity", "is_verified": true, "follower_count": null }, "media": [ { "type": "PHOTO", "url": "https://pbs.twimg.com/media/HQ385vrXsAAOC6x.jpg", "preview_url": null, "width": 1080, "height": 1350 } ], "metrics": null, "referenced_post_ids": [] }, { "post_id": "2093614732028662113", "text": null, "url": "https://x.com/IanCheeseman/status/2093614732028662113", "type": "RETWEETED", "published_at": "2026-08-29T08:20:24.000Z", "author": { "author_id": "56752179", "name": "Ian Cheeseman", "handle": "IanCheeseman", "avatar_url": "https://pbs.twimg.com/profile_images/1796671759967555584/hX0YrdVZ_normal.jpg", "profile_url": "https://x.com/IanCheeseman", "is_verified": false, "follower_count": null }, "media": [], "metrics": null, "referenced_post_ids": [ "2093459412635505131" ] }, { "post_id": "2093613578896961694", "text": "Good morning, Blues 🩵", "url": "https://x.com/ManCity/status/2093613578896961694", "type": "DEFAULT", "published_at": "2026-08-29T08:15:49.000Z", "author": { "author_id": "14573900", "name": "Manchester City", "handle": "ManCity", "avatar_url": "https://pbs.twimg.com/profile_images/1988659455366500352/RbDXMQEB_normal.jpg", "profile_url": "https://x.com/ManCity", "is_verified": true, "follower_count": null }, "media": [ { "type": "PHOTO", "url": "https://pbs.twimg.com/media/HQ4Cc-tWEAAx5S3.jpg", "preview_url": null, "width": 960, "height": 1200 } ], "metrics": null, "referenced_post_ids": [] } ], "post_total_count": 100, "match_id": "1793566" } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/competition-details": { "get": { "tags": [ "Competition" ], "operationId": "/competition-details", "description": "Read the identity and stage structure of a league, cup or tournament.", "parameters": [ { "schema": { "type": "string", "description": "**The league, cup or tournament to read.** Required numeric identifier, sent as text.\n\nGet `competition_id` from `/competitions`, `/search?entity=competition`, `/popular?entity=competition`, `/country-competitions` or `competition.competition_id` on fixture rows.\nA competition identifies the contest; `stage_id` identifies one season or phase. The two can both look like short integers but are not interchangeable. Some fixture groups publish only a stage ID.\nUse competition IDs on competition routes; club statistics require their documented scope pairing. A league need not have a knockout draw even when its ID is valid. Unknown competitions return 404 on addressed competition reads.", "example": "65" }, "required": true, "description": "**The league, cup or tournament to read.** Required numeric identifier, sent as text.\n\nGet `competition_id` from `/competitions`, `/search?entity=competition`, `/popular?entity=competition`, `/country-competitions` or `competition.competition_id` on fixture rows.\nA competition identifies the contest; `stage_id` identifies one season or phase. The two can both look like short integers but are not interchangeable. Some fixture groups publish only a stage ID.\nUse competition IDs on competition routes; club statistics require their documented scope pairing. A league need not have a knockout draw even when its ID is valid. Unknown competitions return 404 on addressed competition reads.", "name": "competition_id", "in": "query" }, { "schema": { "type": "number", "description": "**UTC offset in hours.** Optional; defaults to `0` (UTC). Accepts -12 through 14 as ordinary decimal hours.\n\nFractional offsets include `5.5` (India), `5.75` (Nepal) and `-3.5` (Newfoundland). Offsets strictly between -1 and 0 are unsupported and return 400.\nOn date-addressed requests the offset selects the local-day window; use the same date and offset on related boards and directories. Daylight saving is not selected automatically: send the offset in force for the requested date.\nTimestamp behavior is route-specific. Fixture schedules can contain offset-adjusted wall-clock values with a `Z` suffix; do not assume the suffix alone guarantees UTC at a nonzero offset. Live-board timestamps remain UTC and its offset does not select another live-day window. Use `0` when you need unshifted times and follow the endpoint's time guidance.", "minimum": -12, "maximum": 14 }, "required": false, "description": "**UTC offset in hours.** Optional; defaults to `0` (UTC). Accepts -12 through 14 as ordinary decimal hours.\n\nFractional offsets include `5.5` (India), `5.75` (Nepal) and `-3.5` (Newfoundland). Offsets strictly between -1 and 0 are unsupported and return 400.\nOn date-addressed requests the offset selects the local-day window; use the same date and offset on related boards and directories. Daylight saving is not selected automatically: send the offset in force for the requested date.\nTimestamp behavior is route-specific. Fixture schedules can contain offset-adjusted wall-clock values with a `Z` suffix; do not assume the suffix alone guarantees UTC at a nonzero offset. Live-board timestamps remain UTC and its offset does not select another live-day window. Use `0` when you need unshifted times and follow the endpoint's time guidance.", "name": "timezone", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "The identity card of one league, cup or tournament, with the stage addresses needed to explore its seasons and phases.\n\n**Identity and stages.** `competition` supplies the enduring `competition_id`, names, `competition_slug`, country, badge artwork and brand `color` where published. `stages[]` pairs a stage's own `stage_id` and name with its parent competition identity. `stage_count` is the number of stage entries returned. A competition can have several stages, so do not select the first entry as though it were the whole contest.\n\n**Use the right address.** `/standings`, `/competition-player-stats`, `/competition-team-stats`, `/competition-draw`, `/competition-media` and `/matches-by-competition` take `competition_id`. `stage_id` identifies one season or phase and can be used with `scope=stage` on team statistics. Both are strings and can look numeric; copying the number into the other field does not convert its meaning.\n\n**A stage's `match_count` is the count attached to this detail view, not its season size.** The detail view is day-sensitive; `timezone` defaults to UTC and can change which day's fixtures are attached. Use the fixture routes to read the available match collection and its own count. This endpoint returns stage metadata rather than fixture arrays.\n\n**Flags and missing metadata.** `has_cup_draw`, `sport`, `sport_id`, country subfields and other optional identity fields can be `null`; a missing flag does not establish that the resource is unavailable. The top-level `is_cup` is not a safe substitute for bracket discovery. Check the per-stage records and `/country-competitions`, where `has_cup_draw` can identify a bracket-bearing stage, then address `/competition-draw` by the competition ID.\n\n**Editorial follow-ups.** Pass a prefixed `feed_id` as `/news?id=...`, and each `feed_item_ids` entry as `article_id` to `/article`. A numeric competition ID instead uses `/news?entity=competition&id=...`. `news_id` is a web path for linking out, not the API's news ID input. Feed fields may be `null` or empty when no editorial content is published.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "competition": { "competition_id": "65", "stage_id": null, "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": null, "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": null, "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "has_live_tracker": null, "tier_id": null }, "stages": [ { "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": null, "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": null, "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "has_live_tracker": null, "tier_id": null }, "match_count": 6 } ], "stage_count": 1, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "news_id": "/competition/premier-league-2021020913320920836-3/" } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/standings": { "get": { "tags": [ "Competition" ], "operationId": "/standings", "description": "Read a competition's full standings, including grouped tables, positions and qualification markers where published.", "parameters": [ { "schema": { "type": "string", "description": "**The league, cup or tournament to read.** Required numeric identifier, sent as text.\n\nGet `competition_id` from `/competitions`, `/search?entity=competition`, `/popular?entity=competition`, `/country-competitions` or `competition.competition_id` on fixture rows.\nA competition identifies the contest; `stage_id` identifies one season or phase. The two can both look like short integers but are not interchangeable. Some fixture groups publish only a stage ID.\nUse competition IDs on competition routes; club statistics require their documented scope pairing. A league need not have a knockout draw even when its ID is valid. Unknown competitions return 404 on addressed competition reads.", "example": "65" }, "required": true, "description": "**The league, cup or tournament to read.** Required numeric identifier, sent as text.\n\nGet `competition_id` from `/competitions`, `/search?entity=competition`, `/popular?entity=competition`, `/country-competitions` or `competition.competition_id` on fixture rows.\nA competition identifies the contest; `stage_id` identifies one season or phase. The two can both look like short integers but are not interchangeable. Some fixture groups publish only a stage ID.\nUse competition IDs on competition routes; club statistics require their documented scope pairing. A league need not have a knockout draw even when its ID is valid. Unknown competitions return 404 on addressed competition reads.", "name": "competition_id", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read the standings published for one competition, including every supplied stage, group and table variant. The input is the enduring `competition_id`; discover it in `/competition-details`, `/competitions` or `/country-competitions` where that ID is populated.\n\n**Walk every group and table.** The nesting is `groups[] → tables[] → rows[]`. Groups carry their stage `stage_id` and `name` where available; table `name` can distinguish divisions within a group. Both names can be `null`. `table_scope` identifies `overall`, `home`, `away` or `form`, or is `null` for an unrecognised type. `table_type` also retains the grouping tier. Neither the set of variants nor their ordering is fixed.\n\n**Rows render without a club lookup.** A row is flat: `rank`, `team_id`, `team_name`, `team_short_name`, badge and optional kit artwork, followed by `played`, `won`, `drawn`, `lost`, `goals_for`, `goals_against`, `goal_difference` and `points`. `adjustment` carries a published points adjustment. `win_percentage` is a fraction rather than a percentage from 0 to 100; it can be `null` and should be read with `played`. Sports may also publish regulation, overtime and penalty win/loss columns or `points_for` / `points_against`. Preserve published zeroes and treat `null` as an absent value, rather than computing a substitute.\n\n**Bands and footnotes are different.** Each row's `zone_ids` names qualification, promotion or relegation markers. Table `zones[]` groups those markers with explicit `ranks`, `row_count`, `label`, `color` and `localization_key`. Ranks need not be contiguous, and a row can belong to several bands. If a label cannot be resolved, the band IDs and ranks remain useful while descriptive fields are `null`. `table_marker_ids` instead names table-level footnotes; `table_notes[]` supplies their `note_id`, `text` and translation key. `/table-legend` provides both vocabularies, and `/translations` provides localized labels.\n\n**Form is conditional.** A `table_scope: \"form\"` variant can carry row `form[]` entries with `match_id` and the published numeric `result`. Open a non-null match ID with `/match-details`; do not invent meanings for unlabelled result codes. Other variants may have empty form lists. Form tables can omit counting columns, so do not treat their nulls as a zero-game season.\n\n**Counts describe rows, not unique clubs.** `row_count` sums the ranked rows across every table in every group. A club represented in both overall and form standings is counted twice. Use an individual `rows.length` for that table's size. Empty `groups` or `row_count: 0` indicates no published ranked rows; it does not establish why the table is empty.\n\nA competition can have no standings yet or no table for its format. An empty success response is valid; a 404 can also reflect an unavailable standings resource and should not by itself be used to validate the competition. `/competition-details` reads the identity. If you hold country and league slugs instead of an ID, use `/league-table`; it has the same response shape but may publish a different set of variants.\n\nThe example abbreviates ranked rows and zone entries while retaining `row_count: 20` from the captured document. The count is not recomputed from the displayed excerpt.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": "ENG" }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "has_live_tracker": null, "tier_id": null }, "groups": [ { "name": "Premier League", "stage_id": "25545", "tables": [ { "name": null, "table_type": 1, "table_scope": "overall", "rows": [ { "rank": 1, "team_id": "12633", "team_name": "Manchester City", "team_short_name": "Man City", "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": "https://storage.livescore.com/images/team-kit-home/medium/8456.png", "played": 5, "won": 5, "drawn": 0, "lost": 0, "goals_for": 13, "goals_against": 5, "goal_difference": 8, "points": 15, "won_regulation": 5, "won_overtime": 0, "won_penalties": 0, "lost_regulation": 0, "lost_overtime": 0, "lost_penalties": 0, "points_for": 0, "points_against": 0, "adjustment": 0, "win_percentage": null, "zone_ids": [ 20 ], "external_reference_id": "SBTP_2_1000000139", "form": [] }, { "rank": 2, "team_id": "2773", "team_name": "Arsenal", "team_short_name": "Arsenal", "badge_url": "https://storage.livescore.com/images/team/medium/enet/9825.png", "badge_file": "enet/9825.png", "kit_url": "https://storage.livescore.com/images/team-kit-home/medium/9825.png", "played": 5, "won": 4, "drawn": 0, "lost": 1, "goals_for": 8, "goals_against": 4, "goal_difference": 4, "points": 12, "won_regulation": 4, "won_overtime": 0, "won_penalties": 0, "lost_regulation": 1, "lost_overtime": 0, "lost_penalties": 0, "points_for": 0, "points_against": 0, "adjustment": 0, "win_percentage": null, "zone_ids": [ 20 ], "external_reference_id": "SBTP_2_1000000085", "form": [] } ], "zones": [ { "zone_id": 15, "ranks": [ 18, 19 ], "row_count": 3, "label": "Relegation", "color": "#961A3D", "localization_key": "@phase_relegation" }, { "zone_id": 20, "ranks": [ 1, 2 ], "row_count": 4, "label": "Champions League", "color": "#0075FF", "localization_key": "@phase_champ_league" } ], "table_marker_ids": [ 150, 211 ], "table_notes": [ { "note_id": 150, "text": "Cup winner qualifies for European competition.", "localization_key": "@phase_info_european_comp" }, { "note_id": 211, "text": "League cup gives UEFA Europa Conference League qualification.", "localization_key": "@phase_info_europa_conf_league_qual" } ] } ] } ], "row_count": 20 } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/competition-player-stats": { "get": { "tags": [ "Competition" ], "operationId": "/competition-player-stats", "description": "Read player leaderboards for a competition, with readable metrics and player/team identities.", "parameters": [ { "schema": { "type": "string", "description": "**The league, cup or tournament to read.** Required numeric identifier, sent as text.\n\nGet `competition_id` from `/competitions`, `/search?entity=competition`, `/popular?entity=competition`, `/country-competitions` or `competition.competition_id` on fixture rows.\nA competition identifies the contest; `stage_id` identifies one season or phase. The two can both look like short integers but are not interchangeable. Some fixture groups publish only a stage ID.\nUse competition IDs on competition routes; club statistics require their documented scope pairing. A league need not have a knockout draw even when its ID is valid. Unknown competitions return 404 on addressed competition reads.", "example": "65" }, "required": true, "description": "**The league, cup or tournament to read.** Required numeric identifier, sent as text.\n\nGet `competition_id` from `/competitions`, `/search?entity=competition`, `/popular?entity=competition`, `/country-competitions` or `competition.competition_id` on fixture rows.\nA competition identifies the contest; `stage_id` identifies one season or phase. The two can both look like short integers but are not interchangeable. Some fixture groups publish only a stage ID.\nUse competition IDs on competition routes; club statistics require their documented scope pairing. A league need not have a knockout draw even when its ID is valid. Unknown competitions return 404 on addressed competition reads.", "name": "competition_id", "in": "query" }, { "schema": { "type": "string", "description": "**Select one leaderboard measure.** Optional; omission returns the default preview boards, not every available measure. An explicit group selects its dedicated board and makes `limit` applicable. Use the documented enum, including singular `assist`. Coverage differs between player and team boards; an unavailable board can be empty or return 404.", "enum": [ "goals", "assist", "shots_on_target", "shots", "big_chances_created", "big_chances_missed", "successful_dribbles", "successful_tackles", "interceptions", "clearances", "blocks", "own_goals", "penalty_conceded", "defender_clean_sheets", "midfielder_clean_sheets", "clean_sheets", "saves_percent", "saves", "goals_conceded", "fouls", "yellow_cards", "red_cards" ], "example": "" }, "required": false, "description": "**Select one leaderboard measure.** Optional; omission returns the default preview boards, not every available measure. An explicit group selects its dedicated board and makes `limit` applicable. Use the documented enum, including singular `assist`. Coverage differs between player and team boards; an unavailable board can be empty or return 404.", "name": "stat_group", "in": "query" }, { "schema": { "type": "string", "description": "**Select a category of returned leaderboards.** Optional; omission keeps the available categories. Accepts attacking, defending, goalkeeping and discipline. Category selection does not guarantee every measure is present in the default result; use `stat_group` for a dedicated board. `row_count` still describes the full returned document before category selection.", "enum": [ "attacking", "defending", "goalkeeping", "discipline" ], "example": "" }, "required": false, "description": "**Select a category of returned leaderboards.** Optional; omission keeps the available categories. Accepts attacking, defending, goalkeeping and discipline. Category selection does not guarantee every measure is present in the default result; use `stat_group` for a dedicated board. `row_count` still describes the full returned document before category selection.", "name": "stat_tab", "in": "query" }, { "schema": { "type": "integer", "description": "**How many results to return.** Optional; omission returns the available rows for this dataset.\nApplies only with stat_group; the default tab overview is a preview and is unaffected. Omission leaves the selected board's published row selection in place.\nAccepts integers from 1 to 200; values outside that range return 400.", "minimum": 1, "maximum": 200 }, "required": false, "description": "**How many results to return.** Optional; omission returns the available rows for this dataset.\nApplies only with stat_group; the default tab overview is a preview and is unaffected. Omission leaves the selected board's published row selection in place.\nAccepts integers from 1 to 200; values outside that range return 400.", "name": "limit", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Player leaderboards for one competition, with player and club identities already attached to the ranked figures. Use `competition_id`, not a stage or a provider tournament key.\n\n**The joined row.** `player` can provide `player_id`, name, photo, position and club identity; `team` supplies the corresponding club ID, name and badge. A non-null `player.player_id` opens `/player-details`, `/player-matches` and `/player-stats`. These are reduced identity records: nationality, shirt number, split names, registration IDs, kit artwork and other fields may be `null`; use a profile or squad route if those fields are needed. A row can have `player: null` and `team: null` while retaining its rank and figures, so guard both objects before rendering.\n\n**Default document versus one board.** With no `stat_group`, `tabs[]` is the published overview: each tab has `tab_id`, `title`, `is_default` and `groups[]`, and each group has `group_id`, `title` and ranked `rows[]`. This can be a short preview with empty categories, rather than every available row from every board. Supply `stat_group` to request one board; that board is in `group`, with the requested name echoed in top-level `group_id`. On a single-board response `tabs` can be empty and `competition` can be `null`, so retain the requested competition ID in your application.\n\n**Category selection.** `stat_tab` selects from the returned `tabs` and is echoed as `stat_tab` when supplied. It does not populate categories absent from the overview, filter the separate `group`, or recalculate `row_count`. The count sums ranked rows in the full returned document before tab narrowing, rather than unique players or clubs.\n\n**Read the ranked figure explicitly.** Each row carries `rank`, `value`, `value_metric` and numeric `metrics` under readable names. A board can include related totals, expected figures, `difference_vs_expected`, `matches_played` or `per_game`. Order by `rank`; display `value` with `value_metric`, because the largest total on a row need not be the ranked column. Shots, shots on target, successful dribbles, successful tackles, interceptions, clearances and blocks use per-game ranking; the player saves and fouls boards do too. Percentage measures such as `saves_percent` / `saves_percent_exact` are percentage values, not fractions.\n\n**Coverage is per board.** The enum validates statistic names, not whether this competition publishes them. A valid requested group can be unavailable and return 404; an empty document or category can also occur. Neither case alone establishes that the competition ID is invalid. Check `/competition-details` for identity and another board for coverage. `stat_group` uses singular `assist` and `penalty_conceded`, while readable measurements can be named `assists` and `penalties_conceded`.\n\nThe accepted board families are attacking (`goals`, `assist`, shots, chances and dribbles), defending (tackles, interceptions, clearances, blocks, own goals, penalties conceded and position-specific clean sheets), goalkeeping (clean sheets, saves, save percentage and goals conceded) and discipline (fouls and cards). Use the parameter enum for the exact spellings.\n\n`limit` applies only to a selected `stat_group`, accepts 1–200 and applies when supplied. Omitting it leaves the board's published row selection in place; it does not impose a page of twenty. A limit on an overview request does not expand or crop its preview boards.\n\nThe example abbreviates tabs, groups and ranked rows; `row_count: 21` is the count from the captured overview, not the length of the displayed excerpt.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "competition": { "competition_id": "65", "name": "Premier League" }, "tabs": [ { "tab_id": "attacking", "title": "Attacking", "is_default": true, "groups": [ { "group_id": "goals", "title": "Goals", "rows": [ { "rank": 1, "player": { "player_id": "15419", "squad_player_id": null, "name": "Erling Haaland", "first_name": null, "last_name": null, "slug": null, "photo_url": "https://storage.livescore.com/images/headshots/medium/29179241.png", "photo_file": "29179241.png", "country": null, "country_slug": null, "country_code": null, "position": null, "position_code": null, "shirt_number": null, "team_id": "12633", "team_name": "Manchester City", "team_badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "team_badge_file": "enet/8456.png" }, "team": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": null, "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "value": 5, "value_metric": "goals", "metrics": { "goals": 5, "expected_goals": 4.4, "difference_vs_expected": 0.6 } }, { "rank": 2, "player": { "player_id": "18647", "squad_player_id": null, "name": "Alexander Isak", "first_name": null, "last_name": null, "slug": null, "photo_url": "https://storage.livescore.com/images/headshots/medium/93070286.png", "photo_file": "93070286.png", "country": null, "country_slug": null, "country_code": null, "position": null, "position_code": null, "shirt_number": null, "team_id": "3340", "team_name": "Liverpool", "team_badge_url": "https://storage.livescore.com/images/team/medium/teambadge/liverpool-2024.png", "team_badge_file": "teambadge/liverpool-2024.png" }, "team": { "team_id": "3340", "name": "Liverpool", "short_name": "Liverpool", "abbreviation": null, "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/teambadge/liverpool-2024.png", "badge_file": "teambadge/liverpool-2024.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "value": 4, "value_metric": "goals", "metrics": { "goals": 4, "expected_goals": 3.5, "difference_vs_expected": 0.5 } } ] }, { "group_id": "assist", "title": "Assists", "rows": [ { "rank": 1, "player": { "player_id": "20054", "squad_player_id": null, "name": "Cody Gakpo", "first_name": null, "last_name": null, "slug": null, "photo_url": "https://storage.livescore.com/images/headshots/medium/37062185.png", "photo_file": "37062185.png", "country": null, "country_slug": null, "country_code": null, "position": null, "position_code": null, "shirt_number": null, "team_id": "3340", "team_name": "Liverpool", "team_badge_url": "https://storage.livescore.com/images/team/medium/teambadge/liverpool-2024.png", "team_badge_file": "teambadge/liverpool-2024.png" }, "team": { "team_id": "3340", "name": "Liverpool", "short_name": "Liverpool", "abbreviation": null, "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/teambadge/liverpool-2024.png", "badge_file": "teambadge/liverpool-2024.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "value": 3, "value_metric": "assists", "metrics": { "assists": 3, "expected_assists": 1.7, "difference_vs_expected": 1.3 } }, { "rank": 2, "player": { "player_id": "37399", "squad_player_id": null, "name": "Antoine Semenyo", "first_name": null, "last_name": null, "slug": null, "photo_url": "https://storage.livescore.com/images/headshots/medium/29194724.png", "photo_file": "29194724.png", "country": null, "country_slug": null, "country_code": null, "position": null, "position_code": null, "shirt_number": null, "team_id": "12633", "team_name": "Manchester City", "team_badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "team_badge_file": "enet/8456.png" }, "team": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": null, "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "value": 3, "value_metric": "assists", "metrics": { "assists": 3, "expected_assists": 1.2, "difference_vs_expected": 1.8 } } ] } ] }, { "tab_id": "defending", "title": "Defending", "is_default": false, "groups": [] } ], "group": null, "row_count": 21, "group_id": null } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/competition-team-stats": { "get": { "tags": [ "Competition" ], "operationId": "/competition-team-stats", "description": "Read team leaderboards for a competition, with readable metrics and team identities.", "parameters": [ { "schema": { "type": "string", "description": "**The league, cup or tournament to read.** Required numeric identifier, sent as text.\n\nGet `competition_id` from `/competitions`, `/search?entity=competition`, `/popular?entity=competition`, `/country-competitions` or `competition.competition_id` on fixture rows.\nA competition identifies the contest; `stage_id` identifies one season or phase. The two can both look like short integers but are not interchangeable. Some fixture groups publish only a stage ID.\nUse competition IDs on competition routes; club statistics require their documented scope pairing. A league need not have a knockout draw even when its ID is valid. Unknown competitions return 404 on addressed competition reads.", "example": "65" }, "required": true, "description": "**The league, cup or tournament to read.** Required numeric identifier, sent as text.\n\nGet `competition_id` from `/competitions`, `/search?entity=competition`, `/popular?entity=competition`, `/country-competitions` or `competition.competition_id` on fixture rows.\nA competition identifies the contest; `stage_id` identifies one season or phase. The two can both look like short integers but are not interchangeable. Some fixture groups publish only a stage ID.\nUse competition IDs on competition routes; club statistics require their documented scope pairing. A league need not have a knockout draw even when its ID is valid. Unknown competitions return 404 on addressed competition reads.", "name": "competition_id", "in": "query" }, { "schema": { "type": "string", "description": "**Select one leaderboard measure.** Optional; omission returns the default preview boards, not every available measure. An explicit group selects its dedicated board and makes `limit` applicable. Use the documented enum, including singular `assist`. Coverage differs between player and team boards; an unavailable board can be empty or return 404.", "enum": [ "goals", "assist", "shots_on_target", "shots", "big_chances_created", "big_chances_missed", "successful_dribbles", "successful_tackles", "interceptions", "clearances", "blocks", "own_goals", "penalty_conceded", "defender_clean_sheets", "midfielder_clean_sheets", "clean_sheets", "saves_percent", "saves", "goals_conceded", "fouls", "yellow_cards", "red_cards" ], "example": "" }, "required": false, "description": "**Select one leaderboard measure.** Optional; omission returns the default preview boards, not every available measure. An explicit group selects its dedicated board and makes `limit` applicable. Use the documented enum, including singular `assist`. Coverage differs between player and team boards; an unavailable board can be empty or return 404.", "name": "stat_group", "in": "query" }, { "schema": { "type": "string", "description": "**Select a category of returned leaderboards.** Optional; omission keeps the available categories. Accepts attacking, defending, goalkeeping and discipline. Category selection does not guarantee every measure is present in the default result; use `stat_group` for a dedicated board. `row_count` still describes the full returned document before category selection.", "enum": [ "attacking", "defending", "goalkeeping", "discipline" ], "example": "" }, "required": false, "description": "**Select a category of returned leaderboards.** Optional; omission keeps the available categories. Accepts attacking, defending, goalkeeping and discipline. Category selection does not guarantee every measure is present in the default result; use `stat_group` for a dedicated board. `row_count` still describes the full returned document before category selection.", "name": "stat_tab", "in": "query" }, { "schema": { "type": "integer", "description": "**How many results to return.** Optional; defaults to 20.\nApplies only with stat_group and defaults to twenty there. It does not resize the default tab overview.\nAccepts integers from 1 to 200; values outside that range return 400.", "minimum": 1, "maximum": 200 }, "required": false, "description": "**How many results to return.** Optional; defaults to 20.\nApplies only with stat_group and defaults to twenty there. It does not resize the default tab overview.\nAccepts integers from 1 to 200; values outside that range return 400.", "name": "limit", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Club leaderboards for one competition, with club names and artwork attached to each ranked row. This is the club-by-club counterpart of `/competition-player-stats`, addressed by the enduring `competition_id`.\n\n**The joined row.** Read the club from `team.team_id`, `name`, `short_name` and `badge_url` where available. The ID opens `/team-details` and the other team workflows. The row's `player` is normally `null` because the competitor is a club, and a missing team join should still be guarded. Abbreviations, country metadata, colours and kit fields may be absent; `/team-details` provides the fuller identity.\n\n**Default document versus one board.** With no `stat_group`, `tabs[]` is the published overview: each tab has `tab_id`, `title`, `is_default` and `groups[]`, and each group has `group_id`, `title` and ranked `rows[]`. This can be a short preview with empty categories, rather than every available row from every board. Supply `stat_group` to request one board; that board is in `group`, with the requested name echoed in top-level `group_id`. On a single-board response `tabs` can be empty and `competition` can be `null`, so retain the requested competition ID in your application.\n\n**Category selection.** `stat_tab` selects from the returned `tabs` and is echoed as `stat_tab` when supplied. It does not populate categories absent from the overview, filter the separate `group`, or recalculate `row_count`. The count sums ranked rows in the full returned document before tab narrowing, rather than unique players or clubs.\n\n**Read the ranked figure explicitly.** Each row carries `rank`, `value`, `value_metric` and numeric `metrics` under readable names. A board can include related totals, expected figures, `difference_vs_expected`, `matches_played` or `per_game`. Order by `rank`; display `value` with `value_metric`, because the largest total on a row need not be the ranked column. Shots, shots on target, successful dribbles, successful tackles, interceptions, clearances and blocks use per-game ranking; the player saves and fouls boards do too. Percentage measures such as `saves_percent` / `saves_percent_exact` are percentage values, not fractions.\n\n**Coverage is per board.** The enum validates statistic names, not whether this competition publishes them. A valid requested group can be unavailable and return 404; an empty document or category can also occur. Neither case alone establishes that the competition ID is invalid. Check `/competition-details` for identity and another board for coverage. `stat_group` uses singular `assist` and `penalty_conceded`, while readable measurements can be named `assists` and `penalties_conceded`.\n\n**Team coverage differs from player coverage.** The common team boards cover goals, assists, shots, dribbles, tackles, interceptions, clearances, blocks, own goals, penalties conceded, clean sheets, goals conceded and cards. Player-specific measures such as save percentage or position-specific clean sheets can be accepted by the shared enum yet have no club board. Use `/competition-player-stats` for the player equivalent; do not infer that every shared name has a team leaderboard.\n\nFor a selected `stat_group`, `limit` accepts 1–200 and defaults to 20 on this route. It has no effect on the default overview. `row_count` describes the rows actually supplied, not the total number of clubs that could have statistics.\n\nThe example abbreviates tabs, groups and ranked rows while retaining `row_count: 15` from the captured overview.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "competition": { "competition_id": "65", "name": "Premier League" }, "tabs": [ { "tab_id": "attacking", "title": "Attacking", "is_default": true, "groups": [ { "group_id": "goals", "title": "Goals", "rows": [ { "rank": 1, "player": null, "team": { "team_id": "2918", "name": "Brighton", "short_name": "Brighton", "abbreviation": null, "country": "England", "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/10204.png", "badge_file": "enet/10204.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "value": 16, "value_metric": "goals", "metrics": { "goals": 16, "expected_goals": 11.5, "difference_vs_expected": 4.5 } }, { "rank": 2, "player": null, "team": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": null, "country": "England", "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "value": 13, "value_metric": "goals", "metrics": { "goals": 13, "expected_goals": 10.4, "difference_vs_expected": 2.6 } } ] }, { "group_id": "assist", "title": "Assists", "rows": [ { "rank": 1, "player": null, "team": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": null, "country": "England", "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "value": 10, "value_metric": "assists", "metrics": { "assists": 10, "expected_assists": 8.3, "difference_vs_expected": 1.7 } }, { "rank": 2, "player": null, "team": { "team_id": "2918", "name": "Brighton", "short_name": "Brighton", "abbreviation": null, "country": "England", "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/10204.png", "badge_file": "enet/10204.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "value": 10, "value_metric": "assists", "metrics": { "assists": 10, "expected_assists": 5.1, "difference_vs_expected": 4.9 } } ] } ] }, { "tab_id": "defending", "title": "Defending", "is_default": false, "groups": [] } ], "group": null, "row_count": 15, "group_id": null } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/league-table": { "get": { "tags": [ "Competition" ], "operationId": "/league-table", "description": "Read full standings by country_slug and league_slug, paired with sport.", "parameters": [ { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" }, { "schema": { "type": "string", "description": "**The country or category slug.** Required text, for example `england`.\n\nCopy `country.code` from competition discovery, `/country-competitions`, country search or a competition's public URL. This field is a slug, not a numeric country ID or two-letter audience code.\nFor league reads, pair it with `league_slug` and `sport`. Numeric IDs do not substitute for slugs. An unavailable slug/sport address can return 404; use `/matches-by-competition` or `/standings` when you hold a numeric competition ID.", "example": "england" }, "required": true, "description": "**The country or category slug.** Required text, for example `england`.\n\nCopy `country.code` from competition discovery, `/country-competitions`, country search or a competition's public URL. This field is a slug, not a numeric country ID or two-letter audience code.\nFor league reads, pair it with `league_slug` and `sport`. Numeric IDs do not substitute for slugs. An unavailable slug/sport address can return 404; use `/matches-by-competition` or `/standings` when you hold a numeric competition ID.", "name": "country_slug", "in": "query" }, { "schema": { "type": "string", "description": "**The league, cup or tournament slug.** Required text, for example `premier-league`.\n\nLook it up in `/country-competitions`, competition discovery or a public competition URL. Competition objects can expose it as `slug` or `competition_slug`; do not derive it by normalizing the name.\nSlugs can include a season or cup-round suffix. For example, `laliga` differs from the guessed `la-liga`. Pair the published value with `country_slug` and `sport`; it is not globally unique.\nA numeric competition ID is a different address. Use the numeric competition routes for IDs; an unavailable slug address returns 404 rather than silently selecting a numeric route.", "example": "premier-league" }, "required": true, "description": "**The league, cup or tournament slug.** Required text, for example `premier-league`.\n\nLook it up in `/country-competitions`, competition discovery or a public competition URL. Competition objects can expose it as `slug` or `competition_slug`; do not derive it by normalizing the name.\nSlugs can include a season or cup-round suffix. For example, `laliga` differs from the guessed `la-liga`. Pair the published value with `country_slug` and `sport`; it is not globally unique.\nA numeric competition ID is a different address. Use the numeric competition routes for IDs; an unavailable slug address returns 404 rather than silently selecting a numeric route.", "name": "league_slug", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read a competition's standings by `sport`, `country_slug` and `league_slug`, without resolving a competition ID first. `/country-competitions` publishes the country and stage slugs used by this route; the same pair addresses `/league-matches`.\n\nThe slug address and numeric `competition_id` are separate workflows. Use `/standings` when you hold the numeric ID. A competition absent under the requested sport and slug pair can return 404; a published competition with no table can return an ordinary success with empty groups.\n\n**Walk every group and table.** The nesting is `groups[] → tables[] → rows[]`. Groups carry their stage `stage_id` and `name` where available; table `name` can distinguish divisions within a group. Both names can be `null`. `table_scope` identifies `overall`, `home`, `away` or `form`, or is `null` for an unrecognised type. `table_type` also retains the grouping tier. Neither the set of variants nor their ordering is fixed.\n\n**Rows render without a club lookup.** A row is flat: `rank`, `team_id`, `team_name`, `team_short_name`, badge and optional kit artwork, followed by `played`, `won`, `drawn`, `lost`, `goals_for`, `goals_against`, `goal_difference` and `points`. `adjustment` carries a published points adjustment. `win_percentage` is a fraction rather than a percentage from 0 to 100; it can be `null` and should be read with `played`. Sports may also publish regulation, overtime and penalty win/loss columns or `points_for` / `points_against`. Preserve published zeroes and treat `null` as an absent value, rather than computing a substitute.\n\n**Bands and footnotes are different.** Each row's `zone_ids` names qualification, promotion or relegation markers. Table `zones[]` groups those markers with explicit `ranks`, `row_count`, `label`, `color` and `localization_key`. Ranks need not be contiguous, and a row can belong to several bands. If a label cannot be resolved, the band IDs and ranks remain useful while descriptive fields are `null`. `table_marker_ids` instead names table-level footnotes; `table_notes[]` supplies their `note_id`, `text` and translation key. `/table-legend` provides both vocabularies, and `/translations` provides localized labels.\n\n**Form is conditional.** A `table_scope: \"form\"` variant can carry row `form[]` entries with `match_id` and the published numeric `result`. Open a non-null match ID with `/match-details`; do not invent meanings for unlabelled result codes. Other variants may have empty form lists. Form tables can omit counting columns, so do not treat their nulls as a zero-game season.\n\n**Counts describe rows, not unique clubs.** `row_count` sums the ranked rows across every table in every group. A club represented in both overall and form standings is counted twice. Use an individual `rows.length` for that table's size. Empty `groups` or `row_count: 0` indicates no published ranked rows; it does not establish why the table is empty.\n\nThis route and `/standings` share a shape, but their available table variants need not coincide. Render the supplied tables rather than assuming overall, home, away and form are all present. Use group and table names when populated, with a fallback for unnamed groups or divisions.\n\nThe example abbreviates the rows and zone entries of the overall and form tables. Its `row_count: 40` belongs to the captured document, including both variants, rather than the rows shown in the excerpt.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": "ENG" }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "has_live_tracker": null, "tier_id": null }, "groups": [ { "name": "Premier League", "stage_id": "25545", "tables": [ { "name": null, "table_type": 1, "table_scope": "overall", "rows": [ { "rank": 1, "team_id": "12633", "team_name": "Manchester City", "team_short_name": "Man City", "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": "https://storage.livescore.com/images/team-kit-home/medium/8456.png", "played": 5, "won": 5, "drawn": 0, "lost": 0, "goals_for": 13, "goals_against": 5, "goal_difference": 8, "points": 15, "won_regulation": 5, "won_overtime": 0, "won_penalties": 0, "lost_regulation": 0, "lost_overtime": 0, "lost_penalties": 0, "points_for": 0, "points_against": 0, "adjustment": 0, "win_percentage": null, "zone_ids": [ 20 ], "external_reference_id": "SBTP_2_1000000139", "form": [] }, { "rank": 2, "team_id": "2773", "team_name": "Arsenal", "team_short_name": "Arsenal", "badge_url": "https://storage.livescore.com/images/team/medium/enet/9825.png", "badge_file": "enet/9825.png", "kit_url": "https://storage.livescore.com/images/team-kit-home/medium/9825.png", "played": 5, "won": 4, "drawn": 0, "lost": 1, "goals_for": 8, "goals_against": 4, "goal_difference": 4, "points": 12, "won_regulation": 4, "won_overtime": 0, "won_penalties": 0, "lost_regulation": 1, "lost_overtime": 0, "lost_penalties": 0, "points_for": 0, "points_against": 0, "adjustment": 0, "win_percentage": null, "zone_ids": [ 20 ], "external_reference_id": "SBTP_2_1000000085", "form": [] } ], "zones": [ { "zone_id": 15, "ranks": [ 18, 19 ], "row_count": 3, "label": "Relegation", "color": "#961A3D", "localization_key": "@phase_relegation" }, { "zone_id": 20, "ranks": [ 1, 2 ], "row_count": 4, "label": "Champions League", "color": "#0075FF", "localization_key": "@phase_champ_league" } ], "table_marker_ids": [ 150, 211 ], "table_notes": [ { "note_id": 150, "text": "Cup winner qualifies for European competition.", "localization_key": "@phase_info_european_comp" }, { "note_id": 211, "text": "League cup gives UEFA Europa Conference League qualification.", "localization_key": "@phase_info_europa_conf_league_qual" } ] }, { "name": null, "table_type": 4, "table_scope": "form", "rows": [ { "rank": 1, "team_id": "12633", "team_name": "Manchester City", "team_short_name": "Man City", "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": "https://storage.livescore.com/images/team-kit-home/medium/8456.png", "played": null, "won": null, "drawn": null, "lost": null, "goals_for": null, "goals_against": null, "goal_difference": 8, "points": 15, "won_regulation": null, "won_overtime": null, "won_penalties": null, "lost_regulation": null, "lost_overtime": null, "lost_penalties": null, "points_for": null, "points_against": null, "adjustment": null, "win_percentage": null, "zone_ids": [], "external_reference_id": "SBTP_2_1000000139", "form": [ { "match_id": "1793586", "result": 1 }, { "match_id": "1793551", "result": 1 } ] }, { "rank": 2, "team_id": "2773", "team_name": "Arsenal", "team_short_name": "Arsenal", "badge_url": "https://storage.livescore.com/images/team/medium/enet/9825.png", "badge_file": "enet/9825.png", "kit_url": "https://storage.livescore.com/images/team-kit-home/medium/9825.png", "played": null, "won": null, "drawn": null, "lost": null, "goals_for": null, "goals_against": null, "goal_difference": 4, "points": 12, "won_regulation": null, "won_overtime": null, "won_penalties": null, "lost_regulation": null, "lost_overtime": null, "lost_penalties": null, "points_for": null, "points_against": null, "adjustment": null, "win_percentage": null, "zone_ids": [], "external_reference_id": "SBTP_2_1000000085", "form": [ { "match_id": "1793580", "result": -1 }, { "match_id": "1793560", "result": 1 } ] } ], "zones": [], "table_marker_ids": [], "table_notes": [] } ] } ], "row_count": 40 } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/country-competitions": { "get": { "tags": [ "Competition" ], "operationId": "/country-competitions", "description": "Read the competitions published for a known country or category slug and sport, without a date.", "parameters": [ { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" }, { "schema": { "type": "string", "description": "**The country or category slug.** Required text, for example `england`.\n\nCopy `country.code` from competition discovery, `/country-competitions`, country search or a competition's public URL. This field is a slug, not a numeric country ID or two-letter audience code.\nFor league reads, pair it with `league_slug` and `sport`. Numeric IDs do not substitute for slugs. An unavailable slug/sport address can return 404; use `/matches-by-competition` or `/standings` when you hold a numeric competition ID.", "example": "england" }, "required": true, "description": "**The country or category slug.** Required text, for example `england`.\n\nCopy `country.code` from competition discovery, `/country-competitions`, country search or a competition's public URL. This field is a slug, not a numeric country ID or two-letter audience code.\nFor league reads, pair it with `league_slug` and `sport`. Numeric IDs do not substitute for slugs. An unavailable slug/sport address can return 404; use `/matches-by-competition` or `/standings` when you hold a numeric competition ID.", "name": "country_slug", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Browse the competitions published under one `sport` and `country_slug`, without choosing a date. This is useful for country navigation and competition discovery; `/competitions` instead lists the competitions attached to a particular day.\n\n**Discover both addressing styles.** Each entry in `countries[].competitions[]` is a competition/stage identity with names, country, badge and optional flags. Its `slug` is the `league_slug` accepted by `/league-matches` and `/league-table`. `stage_id` identifies that season or phase. When `competition_id` is populated it addresses `/competition-details`, `/standings`, the competition statistics, media and draw routes. That ID can be `null`; use the slug routes for such entries rather than substituting the stage ID.\n\n**Read directory flags at stage level.** `has_cup_draw` can be populated here even when the same field is absent on competition details. A true value is a useful bracket discovery hint, provided the entry also has a competition ID. A false value on one phase does not rule out a bracket on another phase of the same competition. Group entries by a known competition ID before treating a single phase as the whole contest.\n\n**The country wrapper and counts.** The response retains the common directory shape, with one country entry for the requested slug. Its wrapper `country.name`, `id` and `iso` can be `null`; an individual competition can carry more country information. `country_count` counts wrappers, and `competition_count` counts directory entries, including separate stages of the same contest. `match_count` totals fixtures attached to the directory, not season fixtures. This undated directory normally carries no fixtures, so zero does not mean that its competitions have no schedule.\n\nA country not published for the requested sport can return 404. A known country with an empty directory can return success with no competition entries. Keep the sport with the slug when following links because a country can publish different competitions under different sports.\n\nThe example shows two directory entries from the captured `competition_count: 171`; it abbreviates the collection and feed item lists, rather than defining a fixed directory size.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "countries": [ { "country": { "name": null, "code": "england", "id": null, "iso": null }, "competitions": [ { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": false, "is_cup": false, "feed_id": "cp:65", "feed_item_ids": [ "cp:65-a:4073559", "cp:65-a:4073709" ], "has_live_tracker": null, "tier_id": null }, { "competition_id": "1084", "stage_id": "21997", "name": "Premier League 25/26", "short_name": "Premier League", "display_name": "Premier League 25/26", "slug": "premier-league-2025-2026", "competition_slug": "premier-league-2025-2026", "country": { "name": "England", "code": "england", "id": "34", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": false, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": null } ], "match_count": 0 } ], "country_count": 1, "competition_count": 171, "match_count": 0 } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/competition-draw": { "get": { "tags": [ "Competition" ], "operationId": "/competition-draw", "description": "Read a cup's knockout bracket, rounds and ties.", "parameters": [ { "schema": { "type": "string", "description": "**The league, cup or tournament to read.** Required numeric identifier, sent as text.\n\nGet `competition_id` from `/competitions`, `/search?entity=competition`, `/popular?entity=competition`, `/country-competitions` or `competition.competition_id` on fixture rows.\nA competition identifies the contest; `stage_id` identifies one season or phase. The two can both look like short integers but are not interchangeable. Some fixture groups publish only a stage ID.\nUse competition IDs on competition routes; club statistics require their documented scope pairing. A league need not have a knockout draw even when its ID is valid.", "example": "1078" }, "required": true, "description": "**The league, cup or tournament to read.** Required numeric identifier, sent as text.\n\nGet `competition_id` from `/competitions`, `/search?entity=competition`, `/popular?entity=competition`, `/country-competitions` or `competition.competition_id` on fixture rows.\nA competition identifies the contest; `stage_id` identifies one season or phase. The two can both look like short integers but are not interchangeable. Some fixture groups publish only a stage ID.\nUse competition IDs on competition routes; club statistics require their documented scope pairing. A league need not have a knockout draw even when its ID is valid.", "name": "competition_id", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read the knockout bracket of a cup competition, with fixtures already grouped into their bracket and round. Use the enduring `competition_id` from a directory or competition details, rather than a stage ID.\n\n**Bracket structure.** `brackets[]` can contain several named brackets. Within each, `rounds[]` carries the published `round` number, `name`, `is_pending` and `matches[]`. `round_count` totals rounds across all brackets; `match_count` totals their fixture entries. The response also carries `competition_id`, `competition_slug` and `country_code` where published.\n\n**Use fixture status for progress.** `is_pending` is a published bracket flag whose value is not a reliable test of whether a round has been played or dated. Read each fixture's own `status.code`, score and `start_time`. A finished fixture can appear in a round marked pending.\n\n**Keep bye and undated slots in the bracket.** A slot can have `status.code: \"BYE\"`, a null status label and no `match_id`. Its sides can describe a literal bye or two named clubs awaiting a fixture record. Preserve the row in the bracket, and follow a match workflow only when `match_id` is present. Do not infer a walkover solely from a missing ID or the team `is_placeholder` flag.\n\n**Fixtures and aggregate ties.** Ordinary entries carry team identities, score, status and UTC kickoff time in the same match shape used elsewhere. A non-null match ID opens `/match-details` and the relevant match subresources. Where a tie is modelled as a series, `series` supplies `total_legs`, `current_leg`, `home_aggregate` and `away_aggregate`; `status.aggregate_winner` can identify the advancing side. These fields can be `null` and should not be manufactured for single-leg ties.\n\nA missing bracket can return 404 even for a real league or cup; it does not necessarily mean the competition ID is unknown. `/country-competitions` can provide a `has_cup_draw` discovery hint per stage. Names can be localized, while derived `status.label` remains English; use `status.code` when presenting your own status translations.\n\nThe example abbreviates rounds and fixtures while retaining the captured totals of five rounds and 31 match entries.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "competition_id": "1078", "competition_slug": "champions-league-2025-2026", "country_code": "champions-league", "brackets": [ { "name": "Champions League Final Stage Main", "rounds": [ { "round": 6, "name": "Round of 32", "is_pending": false, "matches": [ { "match_id": "1731875", "status": { "code": "FT", "label": "Finished", "stage_id": 6, "period": 2, "winner": 0, "aggregate_winner": 1 }, "home": { "team_id": "3910", "name": "Paris Saint-Germain", "short_name": "Paris Saint-Germain", "abbreviation": "PSG", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/9847.png", "badge_file": "enet/9847.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/paris-saint-germain-2021020913320920836-295/", "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "4328", "name": "AS Monaco", "short_name": "AS Monaco", "abbreviation": "ASM", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/9829.png", "badge_file": "enet/9829.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/monaco-2022062716001253418-293/", "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": 2, "away_score": 2, "home_score_halftime": 0, "away_score_halftime": 1, "score": { "home": 2, "away": 2, "home_halftime": 0, "away_halftime": 1, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": 2, "away_regulation": 2, "innings": [], "raw": { "Tr1": "2", "Tr2": "2", "Trh1": "0", "Trh2": "1", "Tr1OR": "2", "Tr2OR": "2" } }, "start_time": "2026-02-25T20:00:00.000Z", "start_timestamp": 1772049600, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": "2026-02-25T21:53:59.000Z", "sport_id": 1, "sport": "soccer", "competition": null, "round": "1/16", "coverage": 0, "event_type": 1, "serving": null, "live_clock": null, "has_lineups": null, "series": { "total_legs": 2, "current_leg": 2, "home_aggregate": 5, "away_aggregate": 4 }, "media": { "tv_channels": [], "audio_streams": [], "live_action": [], "stories": [], "highlights": [], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null }, { "match_id": null, "status": { "code": "BYE", "label": null, "stage_id": null, "period": 11, "winner": null, "aggregate_winner": null }, "home": { "team_id": "2881", "name": "Chelsea", "short_name": "Chelsea", "abbreviation": "CHE", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/teambadge/chelsea.png", "badge_file": "teambadge/chelsea.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/chelsea-2021020913320920836-82/", "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": null, "name": "BYE", "short_name": "BYE", "abbreviation": null, "country": null, "country_code": null, "badge_url": null, "badge_file": null, "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": null, "away_score": null, "home_score_halftime": null, "away_score_halftime": null, "score": { "home": null, "away": null, "home_halftime": null, "away_halftime": null, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": null, "away_regulation": null, "innings": [], "raw": {} }, "start_time": null, "start_timestamp": null, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": null, "sport_id": null, "sport": null, "competition": null, "round": null, "coverage": null, "event_type": null, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [], "audio_streams": [], "live_action": [], "stories": [], "highlights": [], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null } ] }, { "round": 5, "name": "Round of 16", "is_pending": false, "matches": [ { "match_id": "1746690", "status": { "code": "FT", "label": "Finished", "stage_id": 6, "period": 2, "winner": 2, "aggregate_winner": 2 }, "home": { "team_id": "2881", "name": "Chelsea", "short_name": "Chelsea", "abbreviation": "CHE", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/teambadge/chelsea.png", "badge_file": "teambadge/chelsea.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/chelsea-2021020913320920836-82/", "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "3910", "name": "Paris Saint-Germain", "short_name": "Paris Saint-Germain", "abbreviation": "PSG", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/9847.png", "badge_file": "enet/9847.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/paris-saint-germain-2021020913320920836-295/", "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": 0, "away_score": 3, "home_score_halftime": 0, "away_score_halftime": 2, "score": { "home": 0, "away": 3, "home_halftime": 0, "away_halftime": 2, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": 0, "away_regulation": 3, "innings": [], "raw": { "Tr1": "0", "Tr2": "3", "Trh1": "0", "Trh2": "2", "Tr1OR": "0", "Tr2OR": "3" } }, "start_time": "2026-03-17T20:00:00.000Z", "start_timestamp": 1773777600, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": "2026-03-17T21:47:37.000Z", "sport_id": 1, "sport": "soccer", "competition": null, "round": "1/8", "coverage": 0, "event_type": 1, "serving": null, "live_clock": null, "has_lineups": null, "series": { "total_legs": 2, "current_leg": 2, "home_aggregate": 2, "away_aggregate": 8 }, "media": { "tv_channels": [], "audio_streams": [], "live_action": [], "stories": [], "highlights": [], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null }, { "match_id": "1746694", "status": { "code": "FT", "label": "Finished", "stage_id": 6, "period": 2, "winner": 1, "aggregate_winner": 1 }, "home": { "team_id": "3340", "name": "Liverpool", "short_name": "Liverpool", "abbreviation": "LIV", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/teambadge/liverpool-2024.png", "badge_file": "teambadge/liverpool-2024.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/liverpool-2021020913320920836-92/", "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "189", "name": "Galatasaray", "short_name": "Galatasaray", "abbreviation": "GAL", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/teambadge/galatasaray.png", "badge_file": "teambadge/galatasaray.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/galatasaray-2022062716001253418-515/", "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": 4, "away_score": 0, "home_score_halftime": 1, "away_score_halftime": 0, "score": { "home": 4, "away": 0, "home_halftime": 1, "away_halftime": 0, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": 4, "away_regulation": 0, "innings": [], "raw": { "Tr1": "4", "Tr2": "0", "Trh1": "1", "Trh2": "0", "Tr1OR": "4", "Tr2OR": "0" } }, "start_time": "2026-03-18T20:00:00.000Z", "start_timestamp": 1773864000, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": "2026-03-18T21:56:59.000Z", "sport_id": 1, "sport": "soccer", "competition": null, "round": "1/8", "coverage": 0, "event_type": 1, "serving": null, "live_clock": null, "has_lineups": null, "series": { "total_legs": 2, "current_leg": 2, "home_aggregate": 4, "away_aggregate": 1 }, "media": { "tv_channels": [], "audio_streams": [], "live_action": [], "stories": [], "highlights": [], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null } ] } ] } ], "round_count": 5, "match_count": 31 } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/competition-media": { "get": { "tags": [ "Competition" ], "operationId": "/competition-media", "description": "Read video playlists attached to one competition.", "parameters": [ { "schema": { "type": "string", "description": "**The league, cup or tournament to read.** Required numeric identifier, sent as text.\n\nGet `competition_id` from `/competitions`, `/search?entity=competition`, `/popular?entity=competition`, `/country-competitions` or `competition.competition_id` on fixture rows.\nA competition identifies the contest; `stage_id` identifies one season or phase. The two can both look like short integers but are not interchangeable. Some fixture groups publish only a stage ID.\nUse competition IDs on competition routes; club statistics require their documented scope pairing. A league need not have a knockout draw even when its ID is valid. Unknown competitions return 404 on addressed competition reads.", "example": "65" }, "required": true, "description": "**The league, cup or tournament to read.** Required numeric identifier, sent as text.\n\nGet `competition_id` from `/competitions`, `/search?entity=competition`, `/popular?entity=competition`, `/country-competitions` or `competition.competition_id` on fixture rows.\nA competition identifies the contest; `stage_id` identifies one season or phase. The two can both look like short integers but are not interchangeable. Some fixture groups publish only a stage ID.\nUse competition IDs on competition routes; club statistics require their documented scope pairing. A league need not have a knockout draw even when its ID is valid. Unknown competitions return 404 on addressed competition reads.", "name": "competition_id", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read video playlists attached to a competition's own page. Use this for its clip archive; `/match-media` supplies the videos attached to an individual fixture.\n\n**Playlists and clips.** Iterate `playlists[] → videos[]`. A playlist carries its `title`, host `type` and `aspect_ratio`; there may be no playlists, and the array does not promise separate themed reels. Each clip carries `video_id`, title, host `stream_id`, `thumbnail_url`, `published_at`, `embeddable` and `type` where published. Publication times are ISO UTC strings; missing titles, identifiers or artwork can be `null`.\n\n**Playback is per clip.** Use the host type and stream identifier together when choosing an embed player. Honour `embeddable` before offering embedded playback. Do not assume every host uses interchangeable video and stream IDs, or that every clip in a playlist has the same playback permission.\n\n**Counts and empty archives.** `video_count` sums clips across the returned playlists; `competition_id` echoes the requested entity. A real competition with no published video can return success with `playlists: []` and `video_count: 0`. An unknown entity ID can return 404, so an empty archive is distinct from a missing identity. Discover the ID from the competition's identity record; a stage ID is not a competition ID.\n\nTitles are supplied by the video publisher. `locale` is accepted, but should not be treated as a guarantee that those titles will be translated. Social posts are available separately for a fixture through `/match-social-posts`.\n\nThe example shows two clips from the captured `video_count: 50`. It abbreviates the clip collection while retaining its original total; the live archive size can change.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "playlists": [ { "title": "YOUTUBE", "type": "YOUTUBE", "aspect_ratio": "16:9", "videos": [ { "video_id": "g_WWfBvIjOg", "title": "RESUMEN: FULHAM 1-1 MANCHESTER UNITED | JORNADA 5 | PREMIER LEAGUE", "stream_id": "g_WWfBvIjOg", "thumbnail_url": "https://i.ytimg.com/vi/g_WWfBvIjOg/mqdefault.jpg", "published_at": "2026-09-20T17:29:17.000Z", "embeddable": true, "type": "Y" }, { "video_id": "fRK_H8g4wIE", "title": "RESUMEN: LEEDS UNITED 0-0 CRYSTAL PALACE | JORNADA 5 | PREMIER LEAGUE", "stream_id": "fRK_H8g4wIE", "thumbnail_url": "https://i.ytimg.com/vi/fRK_H8g4wIE/mqdefault.jpg", "published_at": "2026-09-20T15:00:37.000Z", "embeddable": true, "type": "Y" } ] } ], "video_count": 50, "competition_id": "65" } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/team-details": { "get": { "tags": [ "Team" ], "operationId": "/team-details", "description": "Read a club or national side's identity, colors and workflow addresses.", "parameters": [ { "schema": { "type": "string", "description": "**The club or national side to read.** Required numeric identifier, sent as text.\n\nGet `team_id` from `/search?entity=team`, `/popular?entity=team`, `home.team_id`/`away.team_id` on fixtures, standings or `/resolve`.\nThe ID identifies the side rather than one fixture or season. Reuse it on team routes and for the corresponding club in player season statistics; it is not a player or competition ID.", "example": "12633" }, "required": true, "description": "**The club or national side to read.** Required numeric identifier, sent as text.\n\nGet `team_id` from `/search?entity=team`, `/popular?entity=team`, `home.team_id`/`away.team_id` on fixtures, standings or `/resolve`.\nThe ID identifies the side rather than one fixture or season. Reuse it on team routes and for the corresponding club in player season statistics; it is not a player or competition ID.", "name": "team_id", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read a club or national side's identity and the addresses for its next workflows. This response is the team identity card; competition discovery is on `/team-competitions` and fixture windows are on `/team-fixtures`.\n\n**Identity and artwork.** The `team` block carries `team_id`, `name`, `short_name`, `abbreviation`, country, badge artwork, colours and `web_path` where published. Absolute artwork URLs can be rendered directly; related file fields identify the artwork without guaranteeing that every badge or kit exists. Kit URLs, goalkeeper kits, text colours, sport metadata and other optional fields can be `null`.\n\n**Domestic and statistic addresses.** `domestic_competition_id` is the competition address to try for domestic team statistics and standings discovery. `team_stat_stage_ids` and `player_stat_stage_ids` supply candidate stage addresses for `/team-stats` and `/team-player-stats` with `scope=stage`. The two lists serve different statistics and need not coincide. A listed stage is a discovery hint rather than a guarantee that every requested metric or season pairing is populated.\n\nFor names and the mapping between competitions and stages, follow `/team-competitions`. For up to ten nearest recent and ten nearest upcoming fixtures per competition-stage, follow `/team-fixtures`, optionally filtering by competition or stage. For a single next-match preview with both sides' recent form, use `/team-matches`.\n\n**Editorial addresses.** `feed_id` is the team feed address for `/news?entity=team&id=...`; the numeric team ID can also address team news. Each `feed_item_ids` value is an `article_id` for `/article`. A missing feed or an empty item list means no editorial addresses are supplied, rather than no team.\n\n`has_squad` and `has_video` are published hints; do not treat an absent or false flag as definitive coverage for the corresponding routes. `/team-squad` and `/team-media` return the available collections, which can legitimately be empty. Other optional booleans and names reflect the information present on this record, rather than a completeness guarantee.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "team": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": "MCI", "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#6CABDD", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/manchester-city-2021020913320920836-104/", "has_video": true, "has_squad": true, "is_placeholder": false }, "domestic_competition_id": "65", "feed_id": "pr:12633", "feed_item_ids": [ "pr:12633-a:4073392", "pr:12633-a:4073699" ], "team_stat_stage_ids": [ "18173", "21997" ], "player_stat_stage_ids": [ "18173", "21997" ] } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/team-squad": { "get": { "tags": [ "Team" ], "operationId": "/team-squad", "description": "Read a team's registered players and their identity fields.", "parameters": [ { "schema": { "type": "string", "description": "**The club or national side to read.** Required numeric identifier, sent as text.\n\nGet `team_id` from `/search?entity=team`, `/popular?entity=team`, `home.team_id`/`away.team_id` on fixtures, standings or `/resolve`.\nThe ID identifies the side rather than one fixture or season. Reuse it on team routes and for the corresponding club in player season statistics; it is not a player or competition ID.", "example": "12633" }, "required": true, "description": "**The club or national side to read.** Required numeric identifier, sent as text.\n\nGet `team_id` from `/search?entity=team`, `/popular?entity=team`, `home.team_id`/`away.team_id` on fixtures, standings or `/resolve`.\nThe ID identifies the side rather than one fixture or season. Reuse it on team routes and for the corresponding club in player season statistics; it is not a player or competition ID.", "name": "team_id", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read the registered squad of one club or national side, with player identity, position, shirt number, nationality and headshot artwork where published.\n\n**Carry the canonical player ID forward.** Each player row has `player_id` and `squad_player_id`. Use non-null `player_id` with `/player-details`, `/player-matches`, `/player-stats` and `/resolve`'s `player_ids`. `squad_player_id` identifies the registration with this club, rather than the athlete. Numeric ID spaces can overlap, so substituting the registration ID can even resolve to another person; a successful status is not proof that the field was interchangeable.\n\n**Missing IDs are real coverage limits.** Some squad rows have a name and registration ID but `player_id: null`. Render those rows if useful, but do not substitute another ID to open the player routes. Actor coverage varies by sport and club. An empty `players` list with `player_count: 0` is a valid squad result, and a team's `has_squad` hint should not replace reading this collection.\n\n**A row is not a full profile.** Rows carry `name`, split names, `photo_url`, position and `position_code`, shirt number and country fields where available. Nationality may be expressed through `country` or `country_slug` while `country_code` is absent. Club fields on a player row can be `null`; the enclosing `team` is the squad's club. Use `/player-details` for biography and career history, and `/team-details` for fuller club colours, abbreviation and artwork.\n\n`player_count` is the number of registered player rows returned, including those without a usable actor ID. There is no limit or offset on this endpoint. `feed_id`, when present, opens the club's news feed.\n\nThe example shows two player rows from the captured `player_count: 29`, rather than a two-player squad. The live collection is returned without that documentation abbreviation.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "team": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": null, "country": "England", "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "players": [ { "player_id": "28465", "squad_player_id": "1070712", "name": "Joško Gvardiol", "first_name": "Joško", "last_name": "Gvardiol", "slug": "josko-gvardiol", "photo_url": "https://storage.livescore.com/images/headshots/medium/24060473.png", "photo_file": "24060473.png", "country": "Croatia", "country_slug": "croatia", "country_code": null, "position": "Defender", "position_code": 2, "shirt_number": 24, "team_id": null, "team_name": null, "team_badge_url": null, "team_badge_file": null }, { "player_id": "42312", "squad_player_id": "1089691", "name": "Elliot Anderson", "first_name": "Elliot", "last_name": "Anderson", "slug": "elliot-anderson", "photo_url": "https://storage.livescore.com/images/headshots/medium/28127254.png", "photo_file": "28127254.png", "country": "England", "country_slug": "england", "country_code": null, "position": "Midfielder", "position_code": 3, "shirt_number": 5, "team_id": null, "team_name": null, "team_badge_url": null, "team_badge_file": null } ], "player_count": 29, "feed_id": "pr:12633" } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/team-matches": { "get": { "tags": [ "Team" ], "operationId": "/team-matches", "description": "Read a team's next published fixture and recent form.", "parameters": [ { "schema": { "type": "string", "description": "**The club or national side to read.** Required numeric identifier, sent as text.\n\nGet `team_id` from `/search?entity=team`, `/popular?entity=team`, `home.team_id`/`away.team_id` on fixtures, standings or `/resolve`.\nThe ID identifies the side rather than one fixture or season. Reuse it on team routes and for the corresponding club in player season statistics; it is not a player or competition ID.", "example": "12633" }, "required": true, "description": "**The club or national side to read.** Required numeric identifier, sent as text.\n\nGet `team_id` from `/search?entity=team`, `/popular?entity=team`, `home.team_id`/`away.team_id` on fixtures, standings or `/resolve`.\nThe ID identifies the side rather than one fixture or season. Reuse it on team routes and for the corresponding club in player season statistics; it is not a player or competition ID.", "name": "team_id", "in": "query" }, { "schema": { "type": "integer", "description": "**How many results to return.** Optional; defaults to 10.\nCaps recent form separately for each side of the next fixture, not upcoming fixtures. Defaults to ten; fewer results can be available.\nAccepts integers from 1 to 10; values outside that range return 400.", "minimum": 1, "maximum": 10 }, "required": false, "description": "**How many results to return.** Optional; defaults to 10.\nCaps recent form separately for each side of the next fixture, not upcoming fixtures. Defaults to ten; fewer results can be available.\nAccepts integers from 1 to 10; values outside that range return 400.", "name": "limit", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read one team's next published fixture together with recent form for both sides of that fixture. This is the team-addressed preview workflow; `/team-fixtures` supplies competition-stage result and upcoming windows.\n\n**The next fixture.** `next_match` uses the shared match shape, including `match_id`, home and away identities, competition, status, score, UTC `start_time`, Unix-second `start_timestamp` and media where available. Open its non-null ID with `/match-details` for deeper fixture information. Some metadata, such as round, lineups flags or side colours, may be absent here; use match or team details when needed.\n\n**Both sides' form.** `form.home` and `form.away` refer to the home and away participants of that upcoming fixture, rather than to the requested team and its opponent in request order. Compare their team IDs with your requested `team_id`. Form-side identities can be reduced to an ID, so obtain display names and artwork from `next_match` when they are not supplied in the form block.\n\nEach side's `matches[]` contains recent fixture results with match IDs, teams, scores, status and winner where published. The window can span competitions. Form entries need not carry competition identity, kickoff or full team names; open the individual match ID when that context matters. Do not use a nullable `form.match_id` in place of the next fixture's ID.\n\n**Size and empty state.** `limit` accepts 1–10 and defaults to 10. It caps each side's recent form, rather than the number of upcoming matches or both sides combined. `form_limit` echoes the applied setting; fewer results can be published. `next_match: null` is a valid answer when no next fixture is available, and either form side can be `null` or have an empty match list. Guard those states before rendering.\n\nUse `/team-standings` for the club's table and `/team-fixtures` for its separate competition-stage windows. This preview provides no complete schedule or season guarantee.\n\nThe example abbreviates both recent-form collections; `form_limit: 10` is the requested cap, not a claim that each displayed list contains ten entries.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "team_id": "12633", "next_match": { "match_id": "1793576", "status": { "code": "NS", "label": "Not started", "stage_id": 1, "period": 0, "winner": null, "aggregate_winner": null }, "home": { "team_id": "3340", "name": "Liverpool", "short_name": "Liverpool", "abbreviation": null, "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/teambadge/liverpool-2024.png", "badge_file": "teambadge/liverpool-2024.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/liverpool-2021020913320920836-92/", "has_video": true, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": null, "country": "England", "country_code": "ENG", "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": "/team/manchester-city-2021020913320920836-104/", "has_video": true, "has_squad": null, "is_placeholder": false }, "home_score": null, "away_score": null, "home_score_halftime": null, "away_score_halftime": null, "score": { "home": null, "away": null, "home_halftime": null, "away_halftime": null, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": null, "away_regulation": null, "innings": [], "raw": {} }, "start_time": "2026-10-11T15:30:00.000Z", "start_timestamp": 1791732600, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": null, "sport_id": 1, "sport": "soccer", "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": "ENG" }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": 1, "sport": "soccer", "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": true, "tier_id": "237" }, "round": null, "coverage": null, "event_type": null, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [ { "name": "NOW", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/now.png", "logo_file": "now.png", "countries": [ "IE" ], "excluded_countries": [] }, { "name": "FuboTV", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/fubo.png", "logo_file": "fubo.png", "countries": [ "CA" ], "excluded_countries": [] } ], "audio_streams": [], "live_action": [], "stories": [], "highlights": [], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null }, "form": { "match_id": null, "home": { "team": { "team_id": "3340", "name": null, "short_name": null, "abbreviation": null, "country": null, "country_code": null, "badge_url": null, "badge_file": null, "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "matches": [ { "match_id": "1793578", "status": { "code": "FT", "label": "Finished" }, "start_time": null, "home": { "team_id": "3928", "name": null, "short_name": null, "abbreviation": null, "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8678.png", "badge_file": "enet/8678.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "3340", "name": null, "short_name": null, "abbreviation": null, "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/teambadge/liverpool-2024.png", "badge_file": "teambadge/liverpool-2024.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": 0, "away_score": 1, "winner": 2, "competition": null }, { "match_id": "1880931", "status": { "code": "FT", "label": "Finished" }, "start_time": null, "home": { "team_id": "3340", "name": null, "short_name": null, "abbreviation": null, "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/teambadge/liverpool-2024.png", "badge_file": "teambadge/liverpool-2024.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "3339", "name": null, "short_name": null, "abbreviation": null, "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/teambadge/tottenham-hotspur-2024.png", "badge_file": "teambadge/tottenham-hotspur-2024.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": 3, "away_score": 1, "winner": 1, "competition": null } ] }, "away": { "team": { "team_id": "12633", "name": null, "short_name": null, "abbreviation": null, "country": null, "country_code": null, "badge_url": null, "badge_file": null, "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "matches": [ { "match_id": "1793586", "status": { "code": "FT", "label": "Finished" }, "start_time": null, "home": { "team_id": "12633", "name": null, "short_name": null, "abbreviation": null, "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "2949", "name": null, "short_name": null, "abbreviation": null, "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8472.png", "badge_file": "enet/8472.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": 5, "away_score": 3, "winner": 1, "competition": null }, { "match_id": "1880923", "status": { "code": "FT", "label": "Finished" }, "start_time": null, "home": { "team_id": "12633", "name": null, "short_name": null, "abbreviation": null, "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "2811", "name": null, "short_name": null, "abbreviation": null, "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/9850.png", "badge_file": "enet/9850.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": 5, "away_score": 0, "winner": 1, "competition": null } ] } }, "form_limit": 10 } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/team-standings": { "get": { "tags": [ "Team" ], "operationId": "/team-standings", "description": "Read the table containing a team.", "parameters": [ { "schema": { "type": "string", "description": "**The club or national side to read.** Required numeric identifier, sent as text.\n\nGet `team_id` from `/search?entity=team`, `/popular?entity=team`, `home.team_id`/`away.team_id` on fixtures, standings or `/resolve`.\nThe ID identifies the side rather than one fixture or season. Reuse it on team routes and for the corresponding club in player season statistics; it is not a player or competition ID.", "example": "12633" }, "required": true, "description": "**The club or national side to read.** Required numeric identifier, sent as text.\n\nGet `team_id` from `/search?entity=team`, `/popular?entity=team`, `home.team_id`/`away.team_id` on fixtures, standings or `/resolve`.\nThe ID identifies the side rather than one fixture or season. Reuse it on team routes and for the corresponding club in player season statistics; it is not a player or competition ID.", "name": "team_id", "in": "query" }, { "schema": { "type": "string", "description": "**Select how much of the table to return.** Optional; defaults to `full`. `short` selects a window around the addressed club and `full` returns the available table. Values are text, not numbers. Coverage depends on the club and competition; an unavailable table can be empty or return 404.", "enum": [ "short", "full" ], "example": "" }, "required": false, "description": "**Select how much of the table to return.** Optional; defaults to `full`. `short` selects a window around the addressed club and `full` returns the available table. Values are text, not numbers. Coverage depends on the club and competition; an unavailable table can be empty or return 404.", "name": "table_depth", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read the league table published for a team, using `team_id` without first resolving a competition. The response's `competition` block identifies which table is returned; this route does not enumerate every competition the club enters.\n\n**Choose the row window.** `table_depth` accepts `full` and `short`, with `full` the default. Full requests the published table, while short requests the rows around the club. A short window keeps the original ranks rather than renumbering them, and its size can depend on the club's position and available rows. It is not a selector for just the addressed club.\n\n**Walk every group and table.** The nesting is `groups[] → tables[] → rows[]`. Groups carry their stage `stage_id` and `name` where available; table `name` can distinguish divisions within a group. Both names can be `null`. `table_scope` identifies `overall`, `home`, `away` or `form`, or is `null` for an unrecognised type. `table_type` also retains the grouping tier. Neither the set of variants nor their ordering is fixed.\n\n**Rows render without a club lookup.** A row is flat: `rank`, `team_id`, `team_name`, `team_short_name`, badge and optional kit artwork, followed by `played`, `won`, `drawn`, `lost`, `goals_for`, `goals_against`, `goal_difference` and `points`. `adjustment` carries a published points adjustment. `win_percentage` is a fraction rather than a percentage from 0 to 100; it can be `null` and should be read with `played`. Sports may also publish regulation, overtime and penalty win/loss columns or `points_for` / `points_against`. Preserve published zeroes and treat `null` as an absent value, rather than computing a substitute.\n\n**Bands and footnotes are different.** Each row's `zone_ids` names qualification, promotion or relegation markers. Table `zones[]` groups those markers with explicit `ranks`, `row_count`, `label`, `color` and `localization_key`. Ranks need not be contiguous, and a row can belong to several bands. If a label cannot be resolved, the band IDs and ranks remain useful while descriptive fields are `null`. `table_marker_ids` instead names table-level footnotes; `table_notes[]` supplies their `note_id`, `text` and translation key. `/table-legend` provides both vocabularies, and `/translations` provides localized labels.\n\n**Form is conditional.** A `table_scope: \"form\"` variant can carry row `form[]` entries with `match_id` and the published numeric `result`. Open a non-null match ID with `/match-details`; do not invent meanings for unlabelled result codes. Other variants may have empty form lists. Form tables can omit counting columns, so do not treat their nulls as a zero-game season.\n\n**Counts describe rows, not unique clubs.** `row_count` sums the ranked rows across every table in every group. A club represented in both overall and form standings is counted twice. Use an individual `rows.length` for that table's size. Empty `groups` or `row_count: 0` indicates no published ranked rows; it does not establish why the table is empty.\n\nTeam-addressed tables may contain fewer variants or less row artwork than competition-addressed `/standings` or slug-addressed `/league-table`. Do not assume a form variant is present. `/team-matches` supplies recent form when that is the desired club workflow.\n\nA real club can have no available table and receive 404, or success with empty groups and `row_count: 0`. Handle both as possible table-coverage states; use `/team-details` for identity rather than concluding that every 404 means an unknown club.\n\nThe example abbreviates rows and zones, keeping the captured full table's `row_count: 20`. A live short response counts the rows it actually returns, not the omitted full table.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": "ENG" }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": "pr:12633", "feed_item_ids": [ "pr:12633-a:4073392", "pr:12633-a:4073699" ], "has_live_tracker": null, "tier_id": null }, "groups": [ { "name": "Premier League", "stage_id": "25545", "tables": [ { "name": null, "table_type": 1, "table_scope": "overall", "rows": [ { "rank": 1, "team_id": "12633", "team_name": "Manchester City", "team_short_name": "Man City", "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "played": 5, "won": 5, "drawn": 0, "lost": 0, "goals_for": 13, "goals_against": 5, "goal_difference": 8, "points": 15, "won_regulation": 5, "won_overtime": 0, "won_penalties": 0, "lost_regulation": 0, "lost_overtime": 0, "lost_penalties": 0, "points_for": 0, "points_against": 0, "adjustment": 0, "win_percentage": null, "zone_ids": [ 20 ], "external_reference_id": null, "form": [] }, { "rank": 2, "team_id": "2773", "team_name": "Arsenal", "team_short_name": "Arsenal", "badge_url": "https://storage.livescore.com/images/team/medium/enet/9825.png", "badge_file": "enet/9825.png", "kit_url": null, "played": 5, "won": 4, "drawn": 0, "lost": 1, "goals_for": 8, "goals_against": 4, "goal_difference": 4, "points": 12, "won_regulation": 4, "won_overtime": 0, "won_penalties": 0, "lost_regulation": 1, "lost_overtime": 0, "lost_penalties": 0, "points_for": 0, "points_against": 0, "adjustment": 0, "win_percentage": null, "zone_ids": [ 20 ], "external_reference_id": null, "form": [] } ], "zones": [ { "zone_id": 15, "ranks": [ 18, 19 ], "row_count": 3, "label": "Relegation", "color": "#961A3D", "localization_key": "@phase_relegation" }, { "zone_id": 20, "ranks": [ 1, 2 ], "row_count": 4, "label": "Champions League", "color": "#0075FF", "localization_key": "@phase_champ_league" } ], "table_marker_ids": [ 150, 211 ], "table_notes": [ { "note_id": 150, "text": "Cup winner qualifies for European competition.", "localization_key": "@phase_info_european_comp" }, { "note_id": 211, "text": "League cup gives UEFA Europa Conference League qualification.", "localization_key": "@phase_info_europa_conf_league_qual" } ] } ] } ], "row_count": 20 } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/team-stats": { "get": { "tags": [ "Team" ], "operationId": "/team-stats", "description": "Read season statistics for a team in one competition or stage.", "parameters": [ { "schema": { "type": "string", "description": "**The club or national side to read.** Required numeric identifier, sent as text.\n\nGet `team_id` from `/search?entity=team`, `/popular?entity=team`, `home.team_id`/`away.team_id` on fixtures, standings or `/resolve`.\nThe ID identifies the side rather than one fixture or season. Reuse it on team routes and for the corresponding club in player season statistics; it is not a player or competition ID.", "example": "12633" }, "required": true, "description": "**The club or national side to read.** Required numeric identifier, sent as text.\n\nGet `team_id` from `/search?entity=team`, `/popular?entity=team`, `home.team_id`/`away.team_id` on fixtures, standings or `/resolve`.\nThe ID identifies the side rather than one fixture or season. Reuse it on team routes and for the corresponding club in player season statistics; it is not a player or competition ID.", "name": "team_id", "in": "query" }, { "schema": { "type": "string", "description": "**Select which address identifies the statistics.** Optional; inferred as `stage` when only `stage_id` is supplied, otherwise `competition`. `competition` requires `competition_id`; `stage` requires `stage_id`. If both IDs are supplied, explicitly choose a scope.", "enum": [ "competition", "stage" ], "example": "" }, "required": false, "description": "**Select which address identifies the statistics.** Optional; inferred as `stage` when only `stage_id` is supplied, otherwise `competition`. `competition` requires `competition_id`; `stage` requires `stage_id`. If both IDs are supplied, explicitly choose a scope.", "name": "scope", "in": "query" }, { "schema": { "type": "string", "description": "**The competition whose statistics to read.** Required when the selected or inferred scope is `competition`. Obtain it from competition discovery; a stage ID is a different address.", "example": "65" }, "required": false, "description": "**The competition whose statistics to read.** Required when the selected or inferred scope is `competition`. Obtain it from competition discovery; a stage ID is a different address.", "name": "competition_id", "in": "query" }, { "schema": { "type": "string", "description": "**The season or phase whose statistics to read.** Required when the selected or inferred scope is `stage`. Obtain `stage_id` from `/competitions`, `/team-competitions` or a fixture group." }, "required": false, "description": "**The season or phase whose statistics to read.** Required when the selected or inferred scope is `stage`. Obtain `stage_id` from `/competitions`, `/team-competitions` or a fixture group.", "name": "stage_id", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read one club's published statistics in a competition or stage, grouped into themes such as attacking, defending and discipline, with its competition rank on each measure where provided.\n\n**Measures and units.** `groups[]` contains a group `name` and `stats[]`. Each measure has `name`, `total`, `per_game`, `rank`, `competition_rank` and `team_rank`. `total` and `per_game` are display strings, preserving percentage signs and other units. A null per-game figure can mean the measure is already an average or that no rate was supplied; render the published total and do not replace absence with zero.\n\n`rank` is the club's published rank within the competition on this measure, and `competition_rank` is its alias in this shared statistics shape. `team_rank` is normally null on a club row because the row already represents the club. Published rankings can be absent.\n\n**Pair scope with the correct ID.** Supply `competition_id` for competition statistics or `stage_id` for one season or phase. `scope` is optional when only one of those IDs is supplied: a stage ID selects stage scope, otherwise competition scope is used. If both are supplied, name `scope=competition` or `scope=stage`; both IDs without a scope, neither ID, or a scope without its required companion returns 400. The selected address remains in its own ID space.\n\n`/team-details` supplies `domestic_competition_id` and candidate statistic-stage lists. `/team-competitions` and `/competition-details` give the names and mappings for competition and stage identities. A discovery entry does not guarantee figures for that pairing; an unavailable read can be empty or 404.\n\nThe `team` block supplies the club's header identity, badge and colours where available, but optional abbreviation, country or kit fields may be null. `feed_id` can open club news. `stat_count` sums individual measures across all groups, rather than groups or ranked clubs. A success with empty groups and zero measures indicates that no figures were returned for the addressed pairing; it is not an entity validation result.\n\nFor players ranked within this club use `/team-player-stats`; for the club ranked against other clubs on a board use `/competition-team-stats`.\n\nThe example abbreviates groups and measures, retaining `stat_count: 16` from the captured statistics document.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "team": { "team_id": "12633", "name": "Manchester City", "short_name": null, "abbreviation": null, "country": "England", "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#6CABDD", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "groups": [ { "name": "ATTACKING", "stats": [ { "name": "Average ball possession", "total": "63.7%", "per_game": null, "rank": 2, "team_rank": null, "competition_rank": 2 }, { "name": "Goals scored", "total": "13", "per_game": "2.6", "rank": 2, "team_rank": null, "competition_rank": 2 } ] }, { "name": "DEFENDING", "stats": [ { "name": "Goals conceded", "total": "5", "per_game": "1", "rank": 7, "team_rank": null, "competition_rank": 7 } ] } ], "stat_count": 16, "feed_id": "pr:12633" } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/team-player-stats": { "get": { "tags": [ "Team" ], "operationId": "/team-player-stats", "description": "Read the team's player leaders in one competition or stage.", "parameters": [ { "schema": { "type": "string", "description": "**The club or national side to read.** Required numeric identifier, sent as text.\n\nGet `team_id` from `/search?entity=team`, `/popular?entity=team`, `home.team_id`/`away.team_id` on fixtures, standings or `/resolve`.\nThe ID identifies the side rather than one fixture or season. Reuse it on team routes and for the corresponding club in player season statistics; it is not a player or competition ID.", "example": "12633" }, "required": true, "description": "**The club or national side to read.** Required numeric identifier, sent as text.\n\nGet `team_id` from `/search?entity=team`, `/popular?entity=team`, `home.team_id`/`away.team_id` on fixtures, standings or `/resolve`.\nThe ID identifies the side rather than one fixture or season. Reuse it on team routes and for the corresponding club in player season statistics; it is not a player or competition ID.", "name": "team_id", "in": "query" }, { "schema": { "type": "string", "description": "**Select which address identifies the statistics.** Optional; inferred as `stage` when only `stage_id` is supplied, otherwise `competition`. `competition` requires `competition_id`; `stage` requires `stage_id`. If both IDs are supplied, explicitly choose a scope.", "enum": [ "competition", "stage" ], "example": "" }, "required": false, "description": "**Select which address identifies the statistics.** Optional; inferred as `stage` when only `stage_id` is supplied, otherwise `competition`. `competition` requires `competition_id`; `stage` requires `stage_id`. If both IDs are supplied, explicitly choose a scope.", "name": "scope", "in": "query" }, { "schema": { "type": "string", "description": "**The competition whose statistics to read.** Required when the selected or inferred scope is `competition`. Obtain it from competition discovery; a stage ID is a different address.", "example": "65" }, "required": false, "description": "**The competition whose statistics to read.** Required when the selected or inferred scope is `competition`. Obtain it from competition discovery; a stage ID is a different address.", "name": "competition_id", "in": "query" }, { "schema": { "type": "string", "description": "**The season or phase whose statistics to read.** Required when the selected or inferred scope is `stage`. Obtain `stage_id` from `/competitions`, `/team-competitions` or a fixture group." }, "required": false, "description": "**The season or phase whose statistics to read.** Required when the selected or inferred scope is `stage`. Obtain `stage_id` from `/competitions`, `/team-competitions` or a fixture group.", "name": "stage_id", "in": "query" }, { "schema": { "type": "string", "description": "**Select the statistic to rank by.** Optional; defaults to `goals`. Use a value from the documented enum. Coverage varies by competition and team; an unavailable measure returns no rows.", "enum": [ "goals", "assists", "shots_on_target", "yellow_cards", "red_cards", "shots_off_target", "headed_goals", "penalty_goals", "own_goals", "woodwork_hits" ], "example": "" }, "required": false, "description": "**Select the statistic to rank by.** Optional; defaults to `goals`. Use a value from the documented enum. Coverage varies by competition and team; an unavailable measure returns no rows.", "name": "stat_metric", "in": "query" }, { "schema": { "type": "integer", "description": "**How many results to return.** Optional; omission returns the available rows for this dataset.\nCaps the selected player leaderboard only when supplied. Omission keeps the published row selection rather than imposing a page of ten.\nAccepts integers from 1 to 100; values outside that range return 400.", "minimum": 1, "maximum": 100 }, "required": false, "description": "**How many results to return.** Optional; omission returns the available rows for this dataset.\nCaps the selected player leaderboard only when supplied. Omission keeps the published row selection rather than imposing a page of ten.\nAccepts integers from 1 to 100; values outside that range return 400.", "name": "limit", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Rank one club's players by a published statistic in one competition or stage. Each board in `leaderboards[]` carries its `metric_code` and ranked `players[]`; each row has `rank`, a joined `player` identity and measured figures.\n\n**Joined identity and measurements.** Use the row's canonical `player.player_id` for player details, matches and season statistics. Name, split names, headshot and club identity are supplied where available; position, nationality, shirt number or registration metadata can be absent. `/team-squad` provides those squad fields when needed. Do not confuse a nullable registration field with the player address.\n\n`metrics` keys numeric measurements by readable names such as `goals`, `assists`, `shots_on_target` and `yellow_cards`. `values` carries the same measured figures under numeric metric codes. A row can contain several measurements in addition to the board's ranked metric; use the board identity and `rank` rather than sorting the largest number on the row.\n\n**Select a board and size it.** `stat_metric` defaults to `goals`. Other accepted selections include `assists`, `shots_on_target`, `yellow_cards`, `red_cards`, `shots_off_target`, `headed_goals`, `penalty_goals`, `own_goals` and `woodwork_hits`. This route uses plural `assists`; the competition leaderboard's `stat_group` uses singular `assist`. `limit` accepts 1–100 and applies when supplied. Omission does not apply an API page size of ten; the published board determines the available rows. An explicit limit caps the board rather than guaranteeing that many players.\n\n**Pair scope with the correct ID.** Supply `competition_id` for competition statistics or `stage_id` for one season or phase. `scope` is optional when only one of those IDs is supplied: a stage ID selects stage scope, otherwise competition scope is used. If both are supplied, name `scope=competition` or `scope=stage`; both IDs without a scope, neither ID, or a scope without its required companion returns 400. The selected address remains in its own ID space.\n\n`/team-details` supplies `domestic_competition_id` and candidate statistic-stage lists. `/team-competitions` and `/competition-details` give the names and mappings for competition and stage identities. A discovery entry does not guarantee figures for that pairing; an unavailable read can be empty or 404.\n\nThe response's `team` and optional `feed_id` provide club context. There is no top-level row total; inspect each board's player collection. Missing coverage can leave no boards or no rows, and cannot be used as proof that the requested identities exist.\n\nThe example abbreviates the goals board to two ranked players; it demonstrates the row shape rather than promising a two-player result.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "team": { "team_id": "12633", "name": "Manchester City", "short_name": null, "abbreviation": null, "country": "England", "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#6CABDD", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "leaderboards": [ { "metric_code": 1, "players": [ { "rank": 1, "player": { "player_id": "15419", "squad_player_id": null, "name": "Erling Haaland", "first_name": "Erling", "last_name": "Haaland", "slug": "erling-haaland", "photo_url": "https://storage.livescore.com/images/headshots/medium/29179241.png", "photo_file": "29179241.png", "country": null, "country_slug": null, "country_code": null, "position": null, "position_code": null, "shirt_number": null, "team_id": "12633", "team_name": "Manchester City", "team_badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "team_badge_file": "enet/8456.png" }, "metrics": { "goals": 5 }, "values": { "1": 5 } }, { "rank": 2, "player": { "player_id": "2307", "squad_player_id": null, "name": "Rayan Cherki", "first_name": "Rayan", "last_name": "Cherki", "slug": "rayan-cherki", "photo_url": "https://storage.livescore.com/images/headshots/medium/49056279.png", "photo_file": "49056279.png", "country": null, "country_slug": null, "country_code": null, "position": null, "position_code": null, "shirt_number": null, "team_id": "12633", "team_name": "Manchester City", "team_badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "team_badge_file": "enet/8456.png" }, "metrics": { "goals": 3 }, "values": { "1": 3 } } ] } ], "feed_id": "pr:12633" } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/team-media": { "get": { "tags": [ "Team" ], "operationId": "/team-media", "description": "Read video playlists attached to a club.", "parameters": [ { "schema": { "type": "string", "description": "**The club or national side to read.** Required numeric identifier, sent as text.\n\nGet `team_id` from `/search?entity=team`, `/popular?entity=team`, `home.team_id`/`away.team_id` on fixtures, standings or `/resolve`.\nThe ID identifies the side rather than one fixture or season. Reuse it on team routes and for the corresponding club in player season statistics; it is not a player or competition ID.", "example": "12633" }, "required": true, "description": "**The club or national side to read.** Required numeric identifier, sent as text.\n\nGet `team_id` from `/search?entity=team`, `/popular?entity=team`, `home.team_id`/`away.team_id` on fixtures, standings or `/resolve`.\nThe ID identifies the side rather than one fixture or season. Reuse it on team routes and for the corresponding club in player season statistics; it is not a player or competition ID.", "name": "team_id", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read video playlists attached to a club's own page. Use this for its clip archive; `/match-media` supplies the videos attached to an individual fixture.\n\n**Playlists and clips.** Iterate `playlists[] → videos[]`. A playlist carries its `title`, host `type` and `aspect_ratio`; there may be no playlists, and the array does not promise separate themed reels. Each clip carries `video_id`, title, host `stream_id`, `thumbnail_url`, `published_at`, `embeddable` and `type` where published. Publication times are ISO UTC strings; missing titles, identifiers or artwork can be `null`.\n\n**Playback is per clip.** Use the host type and stream identifier together when choosing an embed player. Honour `embeddable` before offering embedded playback. Do not assume every host uses interchangeable video and stream IDs, or that every clip in a playlist has the same playback permission.\n\n**Counts and empty archives.** `video_count` sums clips across the returned playlists; `team_id` echoes the requested club. A real club with no published video can return success with `playlists: []` and `video_count: 0`. An unknown team ID can return 404, so an empty archive is distinct from a missing identity. Discover `team_id` from team search, fixture sides or `/team-details`.\n\nTitles are supplied by the video publisher. `locale` is accepted, but should not be treated as a guarantee that those titles will be translated. Social posts are available separately for a fixture through `/match-social-posts`.\n\nThe example shows two clips from the captured `video_count: 151`. It abbreviates the clip collection while retaining its original total; the live archive size can change.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "playlists": [ { "title": "YOUTUBE", "type": "YOUTUBE", "aspect_ratio": "16:9", "videos": [ { "video_id": "deJdeo-8Qxw", "title": "RESUMEN: MANCHESTER CITY 5-3 SUNDERLAND | JORNADA 5 | PREMIER LEAGUE", "stream_id": "deJdeo-8Qxw", "thumbnail_url": "https://i.ytimg.com/vi/deJdeo-8Qxw/mqdefault.jpg", "published_at": "2026-09-20T15:26:28.000Z", "embeddable": true, "type": "Y" }, { "video_id": "1zbzm3kyRaQ", "title": "Manchester City vs. Norwich City: Extended Highlights | Carabao Cup | CBS Sports Golazo", "stream_id": "1zbzm3kyRaQ", "thumbnail_url": "https://i.ytimg.com/vi/1zbzm3kyRaQ/mqdefault.jpg", "published_at": "2026-09-17T20:40:03.000Z", "embeddable": true, "type": "Y" } ] } ], "video_count": 151, "team_id": "12633" } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/team-competitions": { "get": { "tags": [ "Team" ], "operationId": "/team-competitions", "description": "Read the competition and stage identities published for a team.", "parameters": [ { "schema": { "type": "string", "description": "**The club or national side to read.** Required numeric identifier, sent as text.\n\nGet `team_id` from `/search?entity=team`, `/popular?entity=team`, `home.team_id`/`away.team_id` on fixtures, standings or `/resolve`.\nThe ID identifies the side rather than one fixture or season. Reuse it on team routes and for the corresponding club in player season statistics; it is not a player or competition ID.", "example": "12633" }, "required": true, "description": "**The club or national side to read.** Required numeric identifier, sent as text.\n\nGet `team_id` from `/search?entity=team`, `/popular?entity=team`, `home.team_id`/`away.team_id` on fixtures, standings or `/resolve`.\nThe ID identifies the side rather than one fixture or season. Reuse it on team routes and for the corresponding club in player season statistics; it is not a player or competition ID.", "name": "team_id", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Discover the competition and stage addresses published for one club or national side. `team_id` echoes the request, and `competitions[]` contains shallow entries with a `competition` identity block.\n\n**Select a season or phase deliberately.** Each block can carry an enduring `competition_id`, its own `stage_id`, names, slugs, country, badge, sport and cup flags. Several entries can belong to the same competition while identifying different stages. Keep the stage ID when selecting a specific phase; do not assume array order picks the current or domestic competition. Optional IDs and metadata can be `null`.\n\n**Follow the available address.** A non-null competition ID opens `/competition-details`, `/standings`, competition leaderboards and `/matches-by-competition`. Pair a non-null stage ID with `scope=stage` for `/team-stats` or `/team-player-stats`, and use `/team-details` for the separate statistic-stage discovery lists. A published identity does not guarantee statistics or a table for every phase.\n\nFor this team's bounded match windows, pass `team_id` and an optional competition or stage filter to `/team-fixtures`. Entries here deliberately contain identities rather than fixture arrays; use the fixture route for scores and kickoffs. `/team-details` remains the identity and editorial address route.\n\nAn empty `competitions` list is a valid result for a known team with no listed stages. There is no pagination or count field on this response; its array length is the number of entries supplied. The example retains two populated identities from the team document, with abbreviated feed item lists.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "team_id": "12633", "competitions": [ { "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": 1, "sport": "soccer", "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": "237" } }, { "competition": { "competition_id": "60", "stage_id": "26261", "name": "League Stage", "short_name": "League Stage", "display_name": "Champions League", "slug": "league-stage", "competition_slug": "champions-league", "country": { "name": "Champions League", "code": "champions-league", "id": "130", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/2023-champions-league.png", "badge_file": "2023-champions-league.png", "color": "#152E58", "sport_id": 1, "sport": "soccer", "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": "1445" } } ] } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/team-fixtures": { "get": { "tags": [ "Team" ], "operationId": "/team-fixtures", "description": "Read the nearest recent and upcoming fixture windows for a team, grouped by competition.", "parameters": [ { "schema": { "type": "string", "description": "**The club or national side to read.** Required numeric identifier, sent as text.\n\nGet `team_id` from `/search?entity=team`, `/popular?entity=team`, `home.team_id`/`away.team_id` on fixtures, standings or `/resolve`.\nThe ID identifies the side rather than one fixture or season. Reuse it on team routes and for the corresponding club in player season statistics; it is not a player or competition ID.", "example": "12633" }, "required": true, "description": "**The club or national side to read.** Required numeric identifier, sent as text.\n\nGet `team_id` from `/search?entity=team`, `/popular?entity=team`, `home.team_id`/`away.team_id` on fixtures, standings or `/resolve`.\nThe ID identifies the side rather than one fixture or season. Reuse it on team routes and for the corresponding club in player season statistics; it is not a player or competition ID.", "name": "team_id", "in": "query" }, { "schema": { "type": "string", "description": "**Select fixtures in one competition.** Optional; omission includes all competitions. Uses `competition_id`, not `stage_id`. Selection happens before pagination; an unmatched ID returns an empty result." }, "required": false, "description": "**Select fixtures in one competition.** Optional; omission includes all competitions. Uses `competition_id`, not `stage_id`. Selection happens before pagination; an unmatched ID returns an empty result.", "name": "competition_id", "in": "query" }, { "schema": { "type": "string", "description": "**Select one season or phase.** Optional numeric stage ID from `/team-competitions`. Selection applies before recent/upcoming windows. If both IDs are sent, both must match; an unmatched selection is empty." }, "required": false, "description": "**Select one season or phase.** Optional numeric stage ID from `/team-competitions`. Selection applies before recent/upcoming windows. If both IDs are sent, both must match; an unmatched selection is empty.", "name": "stage_id", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read the nearest recent and upcoming fixture windows published for one team, grouped by competition-stage. This is useful for a club page's results and upcoming games, with optional `competition_id` and `stage_id` filters discovered on `/team-competitions`.\n\n**Selection and grouping.** `team_id` echoes the request. Every `competitions[]` entry has a `competition` identity, `recent_matches`, `upcoming_matches` and `match_count`. If both filters are supplied, an entry must match both. A filter with no matching entry can return `competitions: []`; it does not independently validate that competition or stage ID.\n\n**The windows are bounded.** Each entry returns at most ten recent fixtures and ten upcoming fixtures. Recent entries are ordered newest kickoff first; upcoming entries are ordered soonest first, with undated fixtures after dated ones. The split is based on kickoff relative to the current time, not on a final-status test, so inspect `status` when you need completed results. An undated fixture belongs to the upcoming list.\n\n**Counts are wider than the visible windows.** Per-entry `match_count` counts every fixture attached to that selected competition-stage in the team document before the two windows are cropped. It can exceed the sum of the recent and upcoming list lengths. It is not a season-completeness promise, and there is no top-level total or pagination on this response.\n\n**Follow fixtures directly.** Match entries use the shared match shape: `match_id`, home and away teams, status, scores, competition and kickoff fields. `start_time` is an ISO UTC string and `start_timestamp` is Unix seconds; an undated kickoff is `null`. Published media and series details can be present, while unavailable sport-specific score fields or flags remain `null`. Use a non-null match ID with `/match-details` and its companion routes.\n\nUse `/team-matches` for one next fixture and both sides' recent form. Use the competition or slug fixture routes when you need their published wider collections; this endpoint does not automatically assemble a complete season.\n\nThe example abbreviates both fixture windows and the collection of competition-stage entries. Each displayed `match_count` retains its value from the complete stage document and therefore need not equal the shown window lengths.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "team_id": "12633", "competitions": [ { "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": 1, "sport": "soccer", "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": "237" }, "recent_matches": [ { "match_id": "1793586", "status": { "code": "FT", "label": "Finished", "stage_id": 6, "period": 2, "winner": 1, "aggregate_winner": null }, "home": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": "MCI", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#6CABDD", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "2949", "name": "Sunderland", "short_name": "Sunderland", "abbreviation": "SUN", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8472.png", "badge_file": "enet/8472.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#EB172B", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": 5, "away_score": 3, "home_score_halftime": null, "away_score_halftime": null, "score": { "home": 5, "away": 3, "home_halftime": null, "away_halftime": null, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": null, "away_regulation": null, "innings": [], "raw": { "Tr1": "5", "Tr2": "3" } }, "start_time": "2026-09-20T13:00:00.000Z", "start_timestamp": 1789909200, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": null, "sport_id": null, "sport": null, "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": 1, "sport": "soccer", "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": "237" }, "round": null, "coverage": null, "event_type": null, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [ { "name": "FuboTV", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/fubo.png", "logo_file": "fubo.png", "countries": [ "CA" ], "excluded_countries": [] }, { "name": "DAZN", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/dazn.png", "logo_file": "dazn.png", "countries": [ "CA" ], "excluded_countries": [] } ], "audio_streams": [], "live_action": [ { "type": "liveactions", "countries": [], "excluded_countries": [] } ], "stories": [ { "type": "Top Plays", "story_url": null, "thumbnail_url": "https://storage.livescore.com/images/story-highlights-thumbnail/high/466b12e6-043d-42f0-8d05-79dbfcf57e98_0.jpg", "thumbnail_file": "466b12e6-043d-42f0-8d05-79dbfcf57e98_0.jpg", "period": "PRE-GAME", "countries": [ "CA" ], "excluded_countries": [] }, { "type": "Top Plays", "story_url": "https://stories.fubo.tv/games/6aa9965d2f2886a7ff60ba26.html", "thumbnail_url": "https://storage.livescore.com/images/story-highlights-thumbnail/high/c1ed8aa4-321a-41d8-880b-1da9680ec445_0.jpg", "thumbnail_file": "c1ed8aa4-321a-41d8-880b-1da9680ec445_0.jpg", "period": "PRE-GAME", "countries": [], "excluded_countries": [ "CA" ] } ], "highlights": [ { "type": "TwitterHighlights", "countries": [ "ZA", "NG" ], "excluded_countries": [] }, { "type": "YoutubeHighlights", "countries": [], "excluded_countries": [] } ], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null }, { "match_id": "1793551", "status": { "code": "FT", "label": "Finished", "stage_id": 6, "period": 2, "winner": 2, "aggregate_winner": null }, "home": { "team_id": "2810", "name": "Manchester United", "short_name": "Manchester United", "abbreviation": "MUN", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/10260.png", "badge_file": "enet/10260.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#DA291C", "secondary": "#000000" }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": "MCI", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#6CABDD", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": 0, "away_score": 1, "home_score_halftime": null, "away_score_halftime": null, "score": { "home": 0, "away": 1, "home_halftime": null, "away_halftime": null, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": null, "away_regulation": null, "innings": [], "raw": { "Tr1": "0", "Tr2": "1" } }, "start_time": "2026-09-13T15:30:00.000Z", "start_timestamp": 1789313400, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": null, "sport_id": null, "sport": null, "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": 1, "sport": "soccer", "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": "237" }, "round": null, "coverage": null, "event_type": null, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [ { "name": "NOW", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/now.png", "logo_file": "now.png", "countries": [ "IE" ], "excluded_countries": [] }, { "name": "FuboTV", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/fubo.png", "logo_file": "fubo.png", "countries": [ "CA", "US" ], "excluded_countries": [] } ], "audio_streams": [], "live_action": [ { "type": "liveactions", "countries": [], "excluded_countries": [] } ], "stories": [ { "type": "Top Plays", "story_url": "https://stories.fubo.tv/games/6aa2ce238a45d7edcf33901c.html", "thumbnail_url": "https://storage.livescore.com/images/story-highlights-thumbnail/high/456f553e-5d51-49ee-b1f5-6dab82815faf_0.jpg", "thumbnail_file": "456f553e-5d51-49ee-b1f5-6dab82815faf_0.jpg", "period": "PRE-GAME", "countries": [], "excluded_countries": [ "TH", "KH" ] }, { "type": "Highlight", "story_url": "https://stories.novasports.gr/games/6aa6c2dc9d7a0890b22046c6.html?utm_source=Livescore_Syndication", "thumbnail_url": "https://storage.livescore.com/images/story-highlights-thumbnail/high/50ff7cc7-c5a7-415f-b8e2-03a7868214b9_0.jpg", "thumbnail_file": "50ff7cc7-c5a7-415f-b8e2-03a7868214b9_0.jpg", "period": "IN-GAME", "countries": [ "GR" ], "excluded_countries": [] } ], "highlights": [ { "type": "TwitterHighlights", "countries": [ "AU", "ZA" ], "excluded_countries": [] }, { "type": "YoutubeHighlights", "countries": [], "excluded_countries": [] } ], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null } ], "upcoming_matches": [ { "match_id": "1793576", "status": { "code": "NS", "label": "Not started", "stage_id": 1, "period": 0, "winner": null, "aggregate_winner": null }, "home": { "team_id": "3340", "name": "Liverpool", "short_name": "Liverpool", "abbreviation": "LIV", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/teambadge/liverpool-2024.png", "badge_file": "teambadge/liverpool-2024.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#C8102E", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": "MCI", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#6CABDD", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": null, "away_score": null, "home_score_halftime": null, "away_score_halftime": null, "score": { "home": null, "away": null, "home_halftime": null, "away_halftime": null, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": null, "away_regulation": null, "innings": [], "raw": {} }, "start_time": "2026-10-11T15:30:00.000Z", "start_timestamp": 1791732600, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": null, "sport_id": null, "sport": null, "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": 1, "sport": "soccer", "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": "237" }, "round": null, "coverage": null, "event_type": null, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [ { "name": "NOW", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/now.png", "logo_file": "now.png", "countries": [ "IE" ], "excluded_countries": [] }, { "name": "FuboTV", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/fubo.png", "logo_file": "fubo.png", "countries": [ "CA" ], "excluded_countries": [] } ], "audio_streams": [ { "stream_url": "https://livesportradio.com/global/reeng7/playlist.m3u8", "excluded_countries": [], "age_restricted": false, "opens_before_seconds": 5, "closes_after_seconds": 15 } ], "live_action": [ { "type": "liveactions", "countries": [], "excluded_countries": [] } ], "stories": [], "highlights": [], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null }, { "match_id": "1793595", "status": { "code": "NS", "label": "Not started", "stage_id": 1, "period": 0, "winner": null, "aggregate_winner": null }, "home": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": "MCI", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#6CABDD", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "2786", "name": "Ipswich Town", "short_name": "Ipswich Town", "abbreviation": "IPS", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/9902.png", "badge_file": "enet/9902.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#3A64A3", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": null, "away_score": null, "home_score_halftime": null, "away_score_halftime": null, "score": { "home": null, "away": null, "home_halftime": null, "away_halftime": null, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": null, "away_regulation": null, "innings": [], "raw": {} }, "start_time": "2026-10-17T14:00:00.000Z", "start_timestamp": 1792245600, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": null, "sport_id": null, "sport": null, "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": "premier-league", "country": { "name": "England", "code": "england", "id": "34", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": 1, "sport": "soccer", "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": "237" }, "round": null, "coverage": null, "event_type": null, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [ { "name": "FuboTV", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/fubo.png", "logo_file": "fubo.png", "countries": [ "CA" ], "excluded_countries": [] }, { "name": "DAZN", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/dazn.png", "logo_file": "dazn.png", "countries": [ "CA" ], "excluded_countries": [] } ], "audio_streams": [ { "stream_url": "https://livesportradio.com/global/reeng7/playlist.m3u8", "excluded_countries": [], "age_restricted": false, "opens_before_seconds": 5, "closes_after_seconds": 15 } ], "live_action": [ { "type": "liveactions", "countries": [], "excluded_countries": [] } ], "stories": [], "highlights": [], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null } ], "match_count": 38 }, { "competition": { "competition_id": "60", "stage_id": "26261", "name": "League Stage", "short_name": "League Stage", "display_name": "Champions League", "slug": "league-stage", "competition_slug": "champions-league", "country": { "name": "Champions League", "code": "champions-league", "id": "130", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/2023-champions-league.png", "badge_file": "2023-champions-league.png", "color": "#152E58", "sport_id": 1, "sport": "soccer", "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": "1445" }, "recent_matches": [ { "match_id": "1882785", "status": { "code": "FT", "label": "Finished", "stage_id": 6, "period": 2, "winner": 2, "aggregate_winner": null }, "home": { "team_id": "262", "name": "FC Porto", "short_name": "FC Porto", "abbreviation": "POR", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/9773.png", "badge_file": "enet/9773.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#00428C", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": "MCI", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#6CABDD", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": 0, "away_score": 2, "home_score_halftime": null, "away_score_halftime": null, "score": { "home": 0, "away": 2, "home_halftime": null, "away_halftime": null, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": null, "away_regulation": null, "innings": [], "raw": { "Tr1": "0", "Tr2": "2" } }, "start_time": "2026-09-08T19:00:00.000Z", "start_timestamp": 1788894000, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": null, "sport_id": null, "sport": null, "competition": { "competition_id": "60", "stage_id": "26261", "name": "League Stage", "short_name": "League Stage", "display_name": "Champions League", "slug": "league-stage", "competition_slug": "champions-league", "country": { "name": "Champions League", "code": "champions-league", "id": "130", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/2023-champions-league.png", "badge_file": "2023-champions-league.png", "color": "#152E58", "sport_id": 1, "sport": "soccer", "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": "1445" }, "round": null, "coverage": null, "event_type": null, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [ { "name": "NOW", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/now.png", "logo_file": "now.png", "countries": [ "IE" ], "excluded_countries": [] }, { "name": "FuboTV", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/fubo.png", "logo_file": "fubo.png", "countries": [ "CA" ], "excluded_countries": [] } ], "audio_streams": [], "live_action": [ { "type": "liveactions", "countries": [], "excluded_countries": [] } ], "stories": [ { "type": "Highlight", "story_url": "https://stories.dazn.com/en-ca/6aa05c795e72d2dbbaf1087c.html?utm_source=Livescore_Syndication", "thumbnail_url": "https://storage.livescore.com/images/story-highlights-thumbnail/high/5baaa302-31b3-4c5a-b257-e83e613395f6_0.jpg", "thumbnail_file": "5baaa302-31b3-4c5a-b257-e83e613395f6_0.jpg", "period": "IN-GAME", "countries": [ "NZ", "CA" ], "excluded_countries": [] }, { "type": "Highlight", "story_url": "https://wsc-cdn.rtl.hu/games/6aa05c69457e66c6e68835d4.html?utm_source=Livescore_Syndication", "thumbnail_url": "https://storage.livescore.com/images/story-highlights-thumbnail/high/fc78589e-1184-46af-a544-a87542364a39_0.jpg", "thumbnail_file": "fc78589e-1184-46af-a544-a87542364a39_0.jpg", "period": "IN-GAME", "countries": [ "HU" ], "excluded_countries": [] } ], "highlights": [ { "type": "TwitterHighlights", "countries": [ "DE", "AU" ], "excluded_countries": [] }, { "type": "YoutubeHighlights", "countries": [], "excluded_countries": [] } ], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null } ], "upcoming_matches": [ { "match_id": "1882755", "status": { "code": "NS", "label": "Not started", "stage_id": 1, "period": 0, "winner": null, "aggregate_winner": null }, "home": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": "MCI", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#6CABDD", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "3910", "name": "Paris Saint-Germain", "short_name": "Paris Saint-Germain", "abbreviation": "PSG", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/9847.png", "badge_file": "enet/9847.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#004170", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": null, "away_score": null, "home_score_halftime": null, "away_score_halftime": null, "score": { "home": null, "away": null, "home_halftime": null, "away_halftime": null, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": null, "away_regulation": null, "innings": [], "raw": {} }, "start_time": "2026-10-14T19:00:00.000Z", "start_timestamp": 1792004400, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": null, "sport_id": null, "sport": null, "competition": { "competition_id": "60", "stage_id": "26261", "name": "League Stage", "short_name": "League Stage", "display_name": "Champions League", "slug": "league-stage", "competition_slug": "champions-league", "country": { "name": "Champions League", "code": "champions-league", "id": "130", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/2023-champions-league.png", "badge_file": "2023-champions-league.png", "color": "#152E58", "sport_id": 1, "sport": "soccer", "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": "1445" }, "round": null, "coverage": null, "event_type": null, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [ { "name": "NOW", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/now.png", "logo_file": "now.png", "countries": [ "IE" ], "excluded_countries": [] }, { "name": "TNT Sports 1", "type": "TV_CHANNEL", "provider": "ABELSON", "logo_url": "https://storage.livescore.com/images/tvchannels/high/tnt-sports.png", "logo_file": "tnt-sports.png", "countries": [ "IE", "GB" ], "excluded_countries": [] } ], "audio_streams": [ { "stream_url": "https://livesportradio.com/global/reeng18/playlist.m3u8", "excluded_countries": [], "age_restricted": false, "opens_before_seconds": 5, "closes_after_seconds": 15 } ], "live_action": [ { "type": "liveactions", "countries": [], "excluded_countries": [] } ], "stories": [], "highlights": [], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null }, { "match_id": "1882776", "status": { "code": "NS", "label": "Not started", "stage_id": 1, "period": 0, "winner": null, "aggregate_winner": null }, "home": { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": "MCI", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#6CABDD", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "4281", "name": "AEK Athens", "short_name": "AEK Athens", "abbreviation": "AEK", "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8563.png", "badge_file": "enet/8563.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#F9D801", "secondary": "#000000" }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "home_score": null, "away_score": null, "home_score_halftime": null, "away_score_halftime": null, "score": { "home": null, "away": null, "home_halftime": null, "away_halftime": null, "home_extra_time": null, "away_extra_time": null, "home_penalties": null, "away_penalties": null, "home_game_points": null, "away_game_points": null, "home_game_points_display": null, "away_game_points_display": null, "sets": [], "periods": [], "home_regulation": null, "away_regulation": null, "innings": [], "raw": {} }, "start_time": "2026-10-20T19:00:00.000Z", "start_timestamp": 1792522800, "end_time": null, "scheduled_days": null, "result_text": null, "event_type_text": null, "updated_at": null, "sport_id": null, "sport": null, "competition": { "competition_id": "60", "stage_id": "26261", "name": "League Stage", "short_name": "League Stage", "display_name": "Champions League", "slug": "league-stage", "competition_slug": "champions-league", "country": { "name": "Champions League", "code": "champions-league", "id": "130", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/2023-champions-league.png", "badge_file": "2023-champions-league.png", "color": "#152E58", "sport_id": 1, "sport": "soccer", "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": "1445" }, "round": null, "coverage": null, "event_type": null, "serving": null, "live_clock": null, "has_lineups": null, "series": null, "media": { "tv_channels": [], "audio_streams": [ { "stream_url": "https://livesportradio.com/global/reeng20/playlist.m3u8", "excluded_countries": [], "age_restricted": false, "opens_before_seconds": 5, "closes_after_seconds": 15 } ], "live_action": [ { "type": "liveactions", "countries": [], "excluded_countries": [] } ], "stories": [], "highlights": [], "other_keys": [] }, "is_featured": false, "is_hidden": false, "is_active": null } ], "match_count": 8 } ] } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/player-details": { "get": { "tags": [ "Player" ], "operationId": "/player-details", "description": "Read an athlete's profile, current club, career and season addresses.", "parameters": [ { "schema": { "type": "string", "description": "**The athlete to read.** Required numeric identifier, sent as text.\n\nUse `player_id` from `/team-squad`, `/search?entity=player`, popular players or a player leaderboard.\nDo not substitute the adjacent `squad_player_id`: it identifies a club registration, and a numerically overlapping value can identify a different athlete rather than simply fail.\nThis ID addresses `/player-details`, `/player-matches` and `/player-stats`; season figures additionally need the corresponding season and team address. Unknown player profiles return 404.", "example": "28465" }, "required": true, "description": "**The athlete to read.** Required numeric identifier, sent as text.\n\nUse `player_id` from `/team-squad`, `/search?entity=player`, popular players or a player leaderboard.\nDo not substitute the adjacent `squad_player_id`: it identifies a club registration, and a numerically overlapping value can identify a different athlete rather than simply fail.\nThis ID addresses `/player-details`, `/player-matches` and `/player-stats`; season figures additionally need the corresponding season and team address. Unknown player profiles return 404.", "name": "player_id", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read an athlete's identity, biography, registrations and career history, then discover correctly paired season and team addresses for player statistics.\n\n**Profile fields.** `player` carries canonical `player_id`, names, photo, nationality fields, position and shirt number where published. `height_cm` is centimetres; `date_of_birth` is an ISO timestamp; `age` is a derived whole-year estimate. `sport` and `sport_id` identify the sport. Optional fields, including a squad registration ID, slug, written country and inline club name or badge, can be null. Use the surrounding team and history collections when their context is supplied there.\n\n**Current registration and dated history.** `teams[]` can include club, national and youth registrations, so its first entry need not be the current senior club. `current` identifies the live registration with team ID, position and shirt number, or is null. Its `season_name` can be absent even when an ID is available. `career[]` supplies team identity, country and start/end dates. `is_current` marks a spell with no end date; it does not resolve every club-versus-national-team distinction. Do not infer registration roles from a reduced team's flags alone.\n\n**Provider competition keys are a different address space.** `competitions[]` lists competition identity and `seasons[]`. Here `competition_id`, and top-level `current_competition_id`, can be provider-prefixed composite tournament keys rather than the numeric IDs used by `/competition-details` and `/standings`. Keep them as grouping keys. `/player-matches` can publish ordinary numeric competition IDs where known; do not send a provider tournament key to a numeric competition endpoint.\n\n**Follow the paired season and team.** A historical `seasons[].season_id` with the `team_id` on that same row, plus this player's ID, addresses `/player-stats`. For the current registration, `current_season_id` and `current.team_id` provide the equivalent pair. Keep the season ID exactly as published, including any provider prefix. `current_stats_available` is a coverage hint for that registration rather than a guarantee that every measure will be returned.\n\n`recent_match_ids` and `highlighted_match_id` provide a small published fixture strip. Open those IDs with `/match-details`; no fixed strip length is promised. `/player-matches` supplies the match log.\n\nDiscover `player_id` through `/team-squad`, player search, popular entities, resolve or leaderboards. Use the canonical field, never `squad_player_id`, which identifies a club registration and can collide numerically with another athlete's ID.\n\nThe example abbreviates registration, career, competition-season and fixture-ID collections while preserving the captured profile values.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "player": { "player_id": "28465", "squad_player_id": null, "name": "Joško Gvardiol", "first_name": "Joško", "last_name": "Gvardiol", "slug": null, "photo_url": "https://storage.livescore.com/images/headshots/medium/24060473.png", "photo_file": "24060473.png", "country": null, "country_slug": "croatia", "country_code": "HRV", "position": "Defender", "position_code": 2, "shirt_number": 24, "team_id": "12633", "team_name": null, "team_badge_url": null, "team_badge_file": null }, "sport_id": 1, "sport": "soccer", "height_cm": 185, "date_of_birth": "2002-01-23T00:00:00.000Z", "age": 24, "teams": [ { "team_id": "12633", "name": "Manchester City", "short_name": "Manchester City", "abbreviation": null, "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "kit_url": "https://storage.livescore.com/images/tshirt/medium/manchester-city.png", "kit_file": "manchester-city.png", "kit_goalkeeper_url": "https://storage.livescore.com/images/tshirt/medium/goalkeeper.png", "kit_goalkeeper_file": "goalkeeper.png", "kit_text_color": "#000000", "kit_goalkeeper_text_color": "#FFFFFF", "colors": { "primary": "#6CABDD", "secondary": "#FDFDFD" }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": true, "is_placeholder": false }, { "team_id": "4707", "name": "RB Leipzig", "short_name": "RB Leipzig", "abbreviation": null, "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/teambadge/rb-leipzig-2024.png", "badge_file": "teambadge/rb-leipzig-2024.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": "#DD013F", "secondary": "#0C2043" }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": true, "is_placeholder": false } ], "career": [ { "team_id": "12633", "team_name": "Manchester City", "team_badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "team_badge_file": "enet/8456.png", "country": "England", "start_date": "2023-08-05T00:00:00.000Z", "end_date": null, "is_current": true }, { "team_id": "4707", "team_name": "RB Leipzig", "team_badge_url": "https://storage.livescore.com/images/team/medium/teambadge/rb-leipzig-2024.png", "team_badge_file": "teambadge/rb-leipzig-2024.png", "country": "Germany", "start_date": "2021-07-01T00:00:00.000Z", "end_date": "2023-08-05T00:00:00.000Z", "is_current": false } ], "competitions": [ { "competition_id": "33-70excpe1synn9kadnbppahdn7", "competition_name": "FIFA World Cup", "competition_slug": "world-cup-2026", "seasons": [ { "season_id": "33-873cbl9cd9butm4air0mugxzo", "season_name": "26", "team_id": "9138", "position": "Defender", "position_code": 2, "shirt_number": 4 } ] }, { "competition_id": "33-2kwbbcootiqqgmrzs6o5inle5", "competition_name": "Premier League", "competition_slug": "england", "seasons": [ { "season_id": "33-6pdwluctev9iebv00r4qqukno", "season_name": "26/27", "team_id": "12633", "position": "Defender", "position_code": 2, "shirt_number": 24 }, { "season_id": "33-51r6ph2woavlbbpk8f29nynf8", "season_name": "25/26", "team_id": "12633", "position": "Defender", "position_code": 2, "shirt_number": 24 } ] } ], "current": { "season_id": "33-6pdwluctev9iebv00r4qqukno", "season_name": null, "team_id": "12633", "position": "Defender", "position_code": 2, "shirt_number": 24 }, "current_season_id": "33-6pdwluctev9iebv00r4qqukno", "current_competition_id": "33-2kwbbcootiqqgmrzs6o5inle5", "current_stats_available": true, "recent_match_ids": [ "1738301", "1738299" ], "highlighted_match_id": "1738299" } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/player-matches": { "get": { "tags": [ "Player" ], "operationId": "/player-matches", "description": "Read the athlete's published appearances grouped by competition, with recorded contributions and minutes.", "parameters": [ { "schema": { "type": "string", "description": "**The athlete to read.** Required numeric identifier, sent as text.\n\nUse `player_id` from `/team-squad`, `/search?entity=player`, popular players or a player leaderboard.\nDo not substitute the adjacent `squad_player_id`: it identifies a club registration, and a numerically overlapping value can identify a different athlete rather than simply fail.\nThis ID addresses `/player-details`, `/player-matches` and `/player-stats`; season figures additionally need the corresponding season and team address. Unknown player profiles return 404.", "example": "28465" }, "required": true, "description": "**The athlete to read.** Required numeric identifier, sent as text.\n\nUse `player_id` from `/team-squad`, `/search?entity=player`, popular players or a player leaderboard.\nDo not substitute the adjacent `squad_player_id`: it identifies a club registration, and a numerically overlapping value can identify a different athlete rather than simply fail.\nThis ID addresses `/player-details`, `/player-matches` and `/player-stats`; season figures additionally need the corresponding season and team address. Unknown player profiles return 404.", "name": "player_id", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read a player's published match log, grouped by competition-stage, including their contribution and involvement where recorded. It can include fixtures where the athlete was named but did not play, rather than appearances alone.\n\n**Groups and fixture addresses.** `competitions[]` pairs a reduced `competition` identity with `matches[]`; `match_count` sums all returned fixture entries across the groups. `stage_id` is useful for grouping a phase, while `competition_id` can be null. When a numeric competition ID is present it opens ordinary competition routes; it is a different address space from the provider tournament keys in `/player-details`. `sport` and `sport_id` name the enclosing sport.\n\nEach match carries `match_id`, UTC `start_time`, `status`, optional numeric `status_id`, and nullable `home` / `away` sides with team IDs, names, artwork and scores. A non-null match ID opens `/match-details` and relevant match subresources. Reduced competition metadata and side details can be absent, so guard them when rendering.\n\n**Player contributions are separate from the team score.** A side can carry `player_goals`, `player_assists`, `player_penalties`, `player_own_goals`, card booleans and `player_minutes`. Contributions concern the requested player, ordinarily on the side they represented, rather than the whole team's figures. A null count means no figure was supplied; a recorded zero is different. Do not sum missing records as zero or rely on numeric `player_minutes` as a complete appearance record. Card flags are supplied as booleans and do not independently establish full coverage.\n\n**Involvement is a display value.** Fixture `minutes_played` is a string, which can contain a minute figure, `XI`, `Sub`, `DNP` or `-`; it is not guaranteed to parse as a number. Preserve it for display rather than converting non-appearance markers to zero. `substituted_on` / `substituted_off` are nullable published strings. `started_on_bench`, `was_injured` and `was_suspended` supply further involvement flags, and `player_result` can state `W`, `D` or `L` from this player's perspective or be null.\n\nUse canonical `player_id` from squad, discovery or profile records, not the club registration ID. A known player with no published events can return empty groups and `match_count: 0`; an unknown player can return 404. The returned log has no pagination or promise of exhaustive career coverage.\n\nThe example abbreviates groups and fixtures while retaining `match_count: 393` from the captured log; that total is not the number of fixture rows printed in the excerpt.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "sport_id": 1, "sport": "soccer", "competitions": [ { "competition": { "competition_id": "734", "stage_id": "19997", "name": "Group L", "short_name": "Group L", "display_name": "Group L", "slug": "group-l", "competition_slug": null, "country": { "name": "World Cup 2026", "code": "world-cup-2026", "id": "616", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/world-cup-ls-logo.png", "badge_file": "world-cup-ls-logo.png", "color": null, "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": null }, "matches": [ { "match_id": "1417979", "start_time": "2026-06-27T21:00:00.000Z", "status": { "code": "FT", "label": "Finished" }, "status_id": 2, "sport_id": 1, "home": { "team_id": "9138", "team_name": "Croatia", "badge_url": "https://storage.livescore.com/images/team/medium/enet/10155.png", "badge_file": "enet/10155.png", "score": 2, "player_goals": 0, "player_assists": 0, "player_penalties": 0, "player_own_goals": 0, "player_yellow_card": false, "player_red_card": false, "player_minutes": 0 }, "away": { "team_id": "9116", "team_name": "Ghana", "badge_url": "https://storage.livescore.com/images/team/medium/enet/6714.png", "badge_file": "enet/6714.png", "score": 1, "player_goals": null, "player_assists": null, "player_penalties": null, "player_own_goals": null, "player_yellow_card": false, "player_red_card": false, "player_minutes": null }, "player_result": "W", "minutes_played": "2'", "substituted_on": "88'", "substituted_off": null, "started_on_bench": true, "was_injured": false, "was_suspended": false }, { "match_id": "1417976", "start_time": "2026-06-23T23:00:00.000Z", "status": { "code": "FT", "label": "Finished" }, "status_id": 2, "sport_id": 1, "home": { "team_id": "9488", "team_name": "Panama", "badge_url": "https://storage.livescore.com/images/team/medium/teambadge/panama-2024.png", "badge_file": "teambadge/panama-2024.png", "score": 0, "player_goals": null, "player_assists": null, "player_penalties": null, "player_own_goals": null, "player_yellow_card": false, "player_red_card": false, "player_minutes": null }, "away": { "team_id": "9138", "team_name": "Croatia", "badge_url": "https://storage.livescore.com/images/team/medium/enet/10155.png", "badge_file": "enet/10155.png", "score": 1, "player_goals": 0, "player_assists": 0, "player_penalties": 0, "player_own_goals": 0, "player_yellow_card": false, "player_red_card": false, "player_minutes": 0 }, "player_result": "W", "minutes_played": "45'", "substituted_on": null, "substituted_off": "45'", "started_on_bench": false, "was_injured": false, "was_suspended": false } ] }, { "competition": { "competition_id": "65", "stage_id": "25545", "name": "Premier League", "short_name": "Premier League", "display_name": "Premier League", "slug": "premier-league", "competition_slug": null, "country": { "name": "England", "code": "england", "id": "34", "iso": null }, "badge_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "badge_file": "premier-league-2024.png", "color": "#3F1152", "sport_id": null, "sport": null, "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": null }, "matches": [ { "match_id": "1793790", "start_time": "2027-05-30T15:00:00.000Z", "status": { "code": "NS", "label": "Not started" }, "status_id": 0, "sport_id": 1, "home": { "team_id": "2949", "team_name": "Sunderland", "badge_url": "https://storage.livescore.com/images/team/medium/enet/8472.png", "badge_file": "enet/8472.png", "score": null, "player_goals": null, "player_assists": null, "player_penalties": null, "player_own_goals": null, "player_yellow_card": false, "player_red_card": false, "player_minutes": null }, "away": { "team_id": "12633", "team_name": "Manchester City", "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "score": null, "player_goals": null, "player_assists": null, "player_penalties": null, "player_own_goals": null, "player_yellow_card": false, "player_red_card": false, "player_minutes": null }, "player_result": null, "minutes_played": "-", "substituted_on": null, "substituted_off": null, "started_on_bench": false, "was_injured": false, "was_suspended": false }, { "match_id": "1793793", "start_time": "2027-05-23T14:00:00.000Z", "status": { "code": "NS", "label": "Not started" }, "status_id": 0, "sport_id": 1, "home": { "team_id": "12633", "team_name": "Manchester City", "badge_url": "https://storage.livescore.com/images/team/medium/enet/8456.png", "badge_file": "enet/8456.png", "score": null, "player_goals": null, "player_assists": null, "player_penalties": null, "player_own_goals": null, "player_yellow_card": false, "player_red_card": false, "player_minutes": null }, "away": { "team_id": "3863", "team_name": "Aston Villa", "badge_url": "https://storage.livescore.com/images/team/medium/teambadge/aston-villa-2024.png", "badge_file": "teambadge/aston-villa-2024.png", "score": null, "player_goals": null, "player_assists": null, "player_penalties": null, "player_own_goals": null, "player_yellow_card": false, "player_red_card": false, "player_minutes": null }, "player_result": null, "minutes_played": "-", "substituted_on": null, "substituted_off": null, "started_on_bench": false, "was_injured": false, "was_suspended": false } ] } ], "match_count": 393 } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/player-stats": { "get": { "tags": [ "Player" ], "operationId": "/player-stats", "description": "Read an athlete's figures for one season and team.", "parameters": [ { "schema": { "type": "string", "description": "**The athlete to read.** Required numeric identifier, sent as text.\n\nUse `player_id` from `/team-squad`, `/search?entity=player`, popular players or a player leaderboard.\nDo not substitute the adjacent `squad_player_id`: it identifies a club registration, and a numerically overlapping value can identify a different athlete rather than simply fail.\nThis ID addresses `/player-details`, `/player-matches` and `/player-stats`; season figures additionally need the corresponding season and team address. Season statistics may be empty for a valid player with no figures in the selected season and team.", "example": "28465" }, "required": true, "description": "**The athlete to read.** Required numeric identifier, sent as text.\n\nUse `player_id` from `/team-squad`, `/search?entity=player`, popular players or a player leaderboard.\nDo not substitute the adjacent `squad_player_id`: it identifies a club registration, and a numerically overlapping value can identify a different athlete rather than simply fail.\nThis ID addresses `/player-details`, `/player-matches` and `/player-stats`; season figures additionally need the corresponding season and team address. Season statistics may be empty for a valid player with no figures in the selected season and team.", "name": "player_id", "in": "query" }, { "schema": { "type": "string", "description": "**The season to read.** Required opaque identifier from `/player-details`.\n\nCopy `competitions[].seasons[].season_id` unchanged, for example `33-51r6ph2woavlbbpk8f29nynf8`, with the matching `player_id` and that record's `team_id`.\nA numeric competition ID is not a season ID. A mismatched season/team/player combination can return empty figures rather than an error, so an empty response is not proof that the address was valid.", "example": "33-51r6ph2woavlbbpk8f29nynf8" }, "required": true, "description": "**The season to read.** Required opaque identifier from `/player-details`.\n\nCopy `competitions[].seasons[].season_id` unchanged, for example `33-51r6ph2woavlbbpk8f29nynf8`, with the matching `player_id` and that record's `team_id`.\nA numeric competition ID is not a season ID. A mismatched season/team/player combination can return empty figures rather than an error, so an empty response is not proof that the address was valid.", "name": "season_id", "in": "query" }, { "schema": { "type": "string", "description": "**The club or national side to read.** Required numeric identifier, sent as text.\n\nGet `team_id` from `/search?entity=team`, `/popular?entity=team`, `home.team_id`/`away.team_id` on fixtures, standings or `/resolve`.\nThe ID identifies the side rather than one fixture or season. Reuse it on team routes and for the corresponding club in player season statistics; it is not a player or competition ID.", "example": "12633" }, "required": true, "description": "**The club or national side to read.** Required numeric identifier, sent as text.\n\nGet `team_id` from `/search?entity=team`, `/popular?entity=team`, `home.team_id`/`away.team_id` on fixtures, standings or `/resolve`.\nThe ID identifies the side rather than one fixture or season. Reuse it on team routes and for the corresponding club in player season statistics; it is not a player or competition ID.", "name": "team_id", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Read one player's statistics for one season and club, with theme groups, season totals and rankings within both the club and the competition.\n\n**Discover the three-part address.** Start with canonical `player_id` from `/team-squad`, player discovery or a profile. `/player-details` then supplies `competitions[].seasons[].season_id` and the `team_id` on the same season row. For the current registration, use `current_season_id` with `current.team_id` when both are populated. All three request IDs are required.\n\nThe season ID can be a provider-prefixed composite string. Preserve it exactly; numeric competition IDs and stage IDs do not identify this season-and-registration record. A season from one row paired with another club can return no figures, even though each separate ID looks valid.\n\n**Groups, units and ranks.** `groups[]` contains group `name` and `stats[]`. Each stat carries `name` and `total` as display strings, preserving units such as minute marks or percentages. `team_rank` is the player's rank on that measure within their own squad, while `competition_rank` is the rank across the competition. `rank` is the competition-rank alias shared with club statistics. Any unpublished total or rank is null. `per_game` is present in the shared stat shape but may be null because player season figures supply totals and ranks rather than a club-style rate.\n\n`stat_count` sums the individual measures across all groups. `is_empty` is true when no measures were returned, including a document with empty named groups. An empty result can mean missing coverage or an incorrectly paired season and team; it is not proof either way about the identities. The route validates required ID syntax but does not independently confirm the entire registration combination. `/player-details` reads the player identity and supplies the pairing.\n\n`/competition-player-stats` ranks players across a competition, and `/team-player-stats` ranks them within one club. This route instead describes the selected individual's published measures for one season and registration.\n\nThe example abbreviates groups and measures while retaining the captured `stat_count: 23` and `is_empty: false`.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "groups": [ { "name": "Matches", "stats": [ { "name": "Matches", "total": "18", "per_game": null, "rank": 332, "team_rank": 16, "competition_rank": 332 }, { "name": "Minutes played", "total": "1374'", "per_game": null, "rank": 261, "team_rank": 15, "competition_rank": 261 } ] }, { "name": "ATTACKING", "stats": [ { "name": "Goals", "total": "2", "per_game": null, "rank": 129, "team_rank": 9, "competition_rank": 129 }, { "name": "Penalty goals", "total": "0", "per_game": null, "rank": 37, "team_rank": 2, "competition_rank": 37 } ] } ], "stat_count": 23, "is_empty": false } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/news": { "get": { "tags": [ "Content" ], "operationId": "/news", "description": "Read editorial articles for a numeric entity ID plus entity kind, a prefixed feed ID, or the curated feed when id is omitted.", "parameters": [ { "schema": { "type": "string", "description": "**The kind of entity named by a numeric news ID.** Required when `id` is numeric; choose competition, team or match. Omit it for a prefixed feed ID or the curated feed.", "enum": [ "competition", "team", "match" ], "example": "" }, "required": false, "description": "**The kind of entity named by a numeric news ID.** Required when `id` is numeric; choose competition, team or match. Omit it for a prefixed feed ID or the curated feed.", "name": "entity", "in": "query" }, { "schema": { "type": "string", "description": "**The entity or feed whose articles to return.** Optional; omission returns the curated feed. Accepts a numeric entity ID with `entity`, or a prefixed feed ID such as `cp:65`, `pr:12633` or `e:1793566`. Pagination requires a scoped ID." }, "required": false, "description": "**The entity or feed whose articles to return.** Optional; omission returns the curated feed. Accepts a numeric entity ID with `entity`, or a prefixed feed ID such as `cp:65`, `pr:12633` or `e:1793566`. Pagination requires a scoped ID.", "name": "id", "in": "query" }, { "schema": { "type": "integer", "description": "**How many results to return.** Optional; defaults to 10.\nPagination requires a scoped news id.\nAccepts integers from 1 to 50; values outside that range return 400.", "minimum": 1, "maximum": 50 }, "required": false, "description": "**How many results to return.** Optional; defaults to 10.\nPagination requires a scoped news id.\nAccepts integers from 1 to 50; values outside that range return 400.", "name": "limit", "in": "query" }, { "schema": { "type": "integer", "description": "**How many results to skip.** Optional; defaults to 0. A zero-based integer from 0 to 10000. Selection happens before the page is taken; an offset beyond the result returns an empty page.\nPagination requires a scoped news id.", "minimum": 0, "maximum": 10000 }, "required": false, "description": "**How many results to skip.** Optional; defaults to 0. A zero-based integer from 0 to 10000. Selection happens before the page is taken; an offset beyond the result returns an empty page.\nPagination requires a scoped news id.", "name": "offset", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Editorial articles for the curated front page or one competition, team, fixture or prefixed feed.\n\n**Choose the feed.** Omit `id` for the curated front page. This is a short strip, not a pageable archive: explicit `limit` or `offset` without a scoped `id` returns 400. Its `entity`, `entity_id`, `limit` and `offset` are null. `total_count`, when present, describes the strip rather than an unseen archive.\n\nFor scoped coverage, send a numeric `id` with `entity=competition`, `team` or `match`, or send a prefixed feed ID such as `cp:65`, `pr:12633`, `e:1793566` or `cs:...` without `entity`. A bare numeric ID without `entity` returns 400. Use `entity_id` to distinguish a scoped response: `entity` can be null for both prefixed feeds and curated news.\n\n**Paging and counts.** Scoped feeds support `limit` (default 10, maximum 50) and `offset` (default 0, maximum 10000). `article_count` counts articles in the returned page; `total_count` is the stated size of that feed edition and may be null. `limit` and `offset` report the applied window when available. Ordering is the feed order, not necessarily strict publication-time order. A feed can have no articles, and its membership can change between page requests.\n\n**Article fields.** Each row has the composite `article_id`, `title`, available `summary` and `author`, publication `source` and `source_id`, canonical `url`, and available `image_url`. `published_at` is ISO 8601; `published_timestamp` is Unix seconds, not milliseconds. Author, summary and artwork can be null. Pass `article_id` unchanged to `/article` to read the anchor and shallow neighboring suggestions.\n\n`ai_generated` is the published declaration about the summary, not an attribution to the credited author. `is_recommended` marks recommendation placement. These flags can be shared across a feed; do not treat them as independent rankings or guarantees about every story.\n\n**Feed discovery.** Curated rows may include `feed` with its title, type and artwork; scoped rows can have `feed: null` because the request already names the feed. The prefix before `-a:` in `article_id` is a scoped feed address. Do not assume `feed.id` alone is prefixed: it can be a bare value such as `65` with `feed.type: \"cp\"`. Public entity records also provide usable `feed_id` values where available.\n\n**Locale and retention.** A locale selects a feed edition and can change membership and totals without translating all scoped headlines or summaries. Use the same locale for `/article`; available article text can differ from the feed excerpt. A missing edition may return empty articles instead of an English fallback. Feeds are rolling windows, not permanent archives: old article IDs can expire and unavailable feeds may return 404.\n\nThe example shows two curated articles from a recorded eight-article strip; counts retain the capture values. Empty articles and nullable paging metadata are valid responses.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "articles": [ { "article_id": "cp:65-a:4073559", "title": "One stat each for 2026-27’s Premier League clubs so far", "summary": "Five matchdays in, the article picks 1 stat per club: City’s 100% start, Brighton’s press, Spurs’ 26 new-player starts and Bournemouth’s 9 points dropped.", "author": "Ali Tweedale", "source": "Opta Analyst", "source_id": 35, "url": "https://theanalyst.com/articles/premier-league-one-stat-for-each-team-2026-27?utm_source=livescore&utm_medium=referral&utm_campaign=foryou", "image_url": "https://theanalyst.com/wp-content/uploads/2026/09/one-stat-to-sum-up-2026-27-so-far-for-every-premier-league-team.jpg", "published_at": "2026-10-05T08:07:36.296Z", "published_timestamp": 1791187656, "ai_generated": true, "is_recommended": true, "feed": { "id": "65", "title": "Premier League", "type": "cp", "image_url": "https://storage.livescore.com/images/competition/medium/premier-league-2024.png", "image_file": "premier-league-2024.png" } }, { "article_id": "cs:1695722410378-a:4073877", "title": "Alex Scott and Ezri Konsa pull out as England injury fears deepen", "summary": "Scott returns to Bournemouth for scans after impressing in the 7-0 Croatia win, while Konsa misses Czechia and leaves Tuchel with 22 players for the camp.", "author": "Dan Bennett", "source": "Hayters", "source_id": 35, "url": "https://hayters.com/arsenal-and-bournemouth-stars-pull-out-of-england-squad-amid-injury-fears/?utm_source=livescore&utm_medium=referral&utm_campaign=foryou", "image_url": "https://icdn.hayters.com/wp-content/uploads/2026/10/croatia-v-england-uefa-nations-league-2026-27-group-a3-md3-3-2.jpg", "published_at": "2026-10-05T09:09:32.414Z", "published_timestamp": 1791191372, "ai_generated": true, "is_recommended": true, "feed": { "id": "cs:1695722410378", "title": "Top headlines", "type": "cs", "image_url": "https://storage.livescore.com/images/media/medium/fire.png", "image_file": "fire.png" } } ], "article_count": 8, "total_count": 8, "limit": null, "offset": null, "entity": null, "entity_id": null } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/article": { "get": { "tags": [ "Content" ], "operationId": "/article", "description": "Read the anchored article and its summary first in articles, followed by shallow neighboring ID, title and link suggestions.", "parameters": [ { "schema": { "type": "string", "description": "**The article to read.** Required composite feed-item ID from `/news`, for example `cp:1000-a:1780770143664`.\n\nThe form is `{feed_id}-a:{article_id}`. Send the row's `article_id` unchanged; the prefix before `-a:` can be used as a scoped news feed ID. Bare numbers return 400 and public article slugs are not accepted.\nUse the same locale as the feed that supplied it. Feed editions can differ, and unavailable language editions may return 404 without an English fallback.\nArticles may expire from rolling feeds; an unavailable ID returns 404. Refresh `/news` rather than assuming a stored ID is permanently readable.", "example": "cp:1000-a:1780770143664" }, "required": true, "description": "**The article to read.** Required composite feed-item ID from `/news`, for example `cp:1000-a:1780770143664`.\n\nThe form is `{feed_id}-a:{article_id}`. Send the row's `article_id` unchanged; the prefix before `-a:` can be used as a scoped news feed ID. Bare numbers return 400 and public article slugs are not accepted.\nUse the same locale as the feed that supplied it. Feed editions can differ, and unavailable language editions may return 404 without an English fallback.\nArticles may expire from rolling feeds; an unavailable ID returns 404. Refresh `/news` rather than assuming a stored ID is permanently readable.", "name": "article_id", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "One article addressed by a composite ID, followed by shallow suggestions from the same feed.\n\n**The anchor is first.** Read the requested article at `articles[0]`; the response-level `article_id` echoes the address. The anchor includes title, available summary and author, publication `source` and `source_id`, canonical `url`, artwork, publication times and editorial flags. `summary` can be null; it is not a guaranteed full article body. `published_at` is ISO 8601 and `published_timestamp` is Unix seconds.\n\n**Suggestions have a smaller shape.** Subsequent `articles` entries contain only `article_id`, `title`, `url`, `image_url` and `published_at`. They are independently addressable through this endpoint; request their IDs to obtain their anchor fields. Do not expect the anchor's summary, author, flags or numeric publication timestamp on these suggestion rows.\n\n**Counts and feed position.** `article_count` counts the anchor and suggestions returned in the window; `total_count` describes the feed edition when stated. `limit` and `offset` describe the returned window and anchor position when available, not request controls on this endpoint. The window can be shorter near a feed's end; it is not a guaranteed number of related stories. Use `/news` with the feed ID for a wider feed view.\n\n**ID workflow.** Obtain `article_id` from `/news`, for example `cp:65-a:4073559`. Its prefix before `-a:` is the feed ID (`cp:65`) accepted by `/news`. A bare number is rejected with 400; public article slugs are not supported. Keep the composite ID unchanged rather than trying to derive it from a title or URL.\n\n**Expiry and locale.** An article may stop resolving when it leaves its rolling feed; there is no guaranteed retention period. An unavailable or expired article returns 404. Refresh `/news` rather than assuming a stored ID is permanent. Use the same locale as the feed that supplied the ID: editions can have different membership, and an unavailable language edition can return 404 without falling back to English. Translation and summary availability depend on the article and edition.\n\nThe example shows the anchor and one shallow suggestion from a recorded four-article window. Its counts describe that window, not just the two entries illustrated.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "articles": [ { "article_id": "cp:1000-a:1780770143664", "title": "Anthony Martial and Monterrey agree mutual contract termination – French striker becomes free agent", "summary": null, "author": "www.businessupturn.com", "source": "www.businessupturn.com", "source_id": 8, "url": "https://www.businessupturn.com/sports/football/transfer-news/anthony-martial-and-rayados-agree-mutual-contract-termination-french-striker-becomes-free-agent/?utm_source=livescore&utm_medium=referral&utm_campaign=foryou", "image_url": "https://www.businessupturn.com/sports/wp-content/uploads/sites/4/2026/06/Untitled-design-11-1.jpg", "published_at": "2026-06-06T18:18:51.000Z", "published_timestamp": 1780769931, "ai_generated": true, "is_recommended": false, "feed": null }, { "article_id": "cp:1000-a:1776186320645", "title": "Mascherano steps down as Inter Miami head coach after historic MLS Cup triumphs", "url": "https://www.intermiamicf.com/news/head-coach-javier-mascherano-departs-inter-miami-cf?utm_source=livescore&utm_medium=referral&utm_campaign=foryou", "image_url": "https://images.mlssoccer.com/image/private/t_editorial_landscape_3_4_desktop/mls-mia/rzgqppllaaj6dcmgiwte.jpg", "published_at": "2026-04-14T16:49:00.000Z" } ], "article_count": 4, "total_count": 4, "limit": 4, "offset": 0, "article_id": "cp:1000-a:1780770143664" } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/tv-guide": { "get": { "tags": [ "Content" ], "operationId": "/tv-guide", "description": "Read broadcast listings for a country, with channel names and fixture information.", "parameters": [ { "schema": { "type": "string", "description": "**The audience or broadcast country.** Optional; defaults to `gb`. Two-letter country code, case-insensitive.\n\nThe value selects the requested audience, not the caller's physical location. `/sports` returns the preferred sport order and reports `is_country_specific`; a code without its own ordering can use the default.\nOn `/tv-guide` it selects broadcast listings. Read `available_in_country` and `total_count`: a valid country can have no current guide, and an empty page does not establish permanent lack of coverage.\nA value that is not two letters returns 400." }, "required": false, "description": "**The audience or broadcast country.** Optional; defaults to `gb`. Two-letter country code, case-insensitive.\n\nThe value selects the requested audience, not the caller's physical location. `/sports` returns the preferred sport order and reports `is_country_specific`; a code without its own ordering can use the default.\nOn `/tv-guide` it selects broadcast listings. Read `available_in_country` and `total_count`: a valid country can have no current guide, and an empty page does not establish permanent lack of coverage.\nA value that is not two letters returns 400.", "name": "country_code", "in": "query" }, { "schema": { "type": "integer", "description": "**How many results to return.** Optional; defaults to 20.\nThe limit caps the selected result list.\nAccepts integers from 1 to 500; values outside that range return 400.", "minimum": 1, "maximum": 500 }, "required": false, "description": "**How many results to return.** Optional; defaults to 20.\nThe limit caps the selected result list.\nAccepts integers from 1 to 500; values outside that range return 400.", "name": "limit", "in": "query" }, { "schema": { "type": "integer", "description": "**How many results to skip.** Optional; defaults to 0. A zero-based integer from 0 to 100000. Selection happens before the page is taken; an offset beyond the result returns an empty page.\nSkip rows within the selected result list.", "minimum": 0, "maximum": 100000 }, "required": false, "description": "**How many results to skip.** Optional; defaults to 0. A zero-based integer from 0 to 100000. Selection happens before the page is taken; an offset beyond the result returns an empty page.\nSkip rows within the selected result list.", "name": "offset", "in": "query" }, { "schema": { "type": "string", "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "enum": [ "en", "ar", "bg", "de", "es", "fr", "id", "it", "ms", "nl", "pl", "pt", "ro", "sv", "th", "uk", "vi", "zh" ], "example": "" }, "required": false, "description": "**Language for localized names and text.** Optional; defaults to `en`. Accepts the documented language codes, case-insensitively. Original article, media and authored text may retain its published language. For an article ID, use the locale of the feed that supplied it.", "name": "locale", "in": "query" } ], "responses": { "200": { "description": "Broadcast listings for the audience country selected by `country_code`, pairing fixtures with available channels.\n\n**Country and availability.** `country_code` is a two-letter, case-insensitive code and defaults to `gb`. It chooses the requested guide, not the caller's physical location. `available_in_country` is true when `total_count` indicates listings, or, without a total, when this page contains listings. An empty page beyond the end can therefore still have `available_in_country: true`. A false flag does not establish permanent lack of coverage for that country; both an empty schedule and unavailable current coverage can produce it. Valid empty guides return 200.\n\n**Fixture and carrier.** Each `listings` row has `match_id`, ISO `start_time`, a `status` code/label, numeric `status_id`, sport identifiers, a competition object and home/away teams with available names and artwork. `channels` is an array of channel type/name pairs, not a guarantee of every broadcaster carrying the fixture. `TV` identifies television listings; `BET` identifies betting-stream coverage and can have a null channel name. Render nullable names defensively.\n\n**Paging.** `listing_count` counts rows in this page; `total_count` is the stated guide total and can be null. `offset` is the applied starting position and `has_more` indicates whether the stated total extends beyond this page. Without a total, `has_more` is false and should not be treated as proof that all possible listings were enumerated. `limit` defaults to 20, with a maximum of 500; `offset` defaults to 0 and accepts up to 100000. An offset beyond the guide returns an empty page rather than an error.\n\n**Live state and drill-down.** A listing can be scheduled, running or finished; read its status instead of treating presence in the guide as proof it is on air. There is no `live` parameter: this endpoint has no live-only filter, and requests using that retired control return 400. A fixture's `match_id` can be passed to focused match routes; carry its sport when the destination accepts `sport`.\n\nLocale does not guarantee translated channel names or authored fixture text. The example abbreviates a recorded guide to two listings and retains its recorded page/guide counts.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "listings": [ { "match_id": "1902143", "start_time": "2026-10-05T10:30:00.000Z", "status": { "code": "NS", "label": "Not started" }, "status_id": 0, "sport_id": 1, "sport": "soccer", "competition": { "competition_id": "537", "stage_id": "24073", "name": "Friendlies", "short_name": null, "display_name": null, "slug": "friendlies", "competition_slug": "friendlies", "country": { "name": "International Friendlies", "code": "international-friendlies", "id": "576", "iso": null }, "badge_url": null, "badge_file": null, "color": null, "sport_id": 1, "sport": "soccer", "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": null }, "home": { "team_id": "6326", "name": "Japan", "short_name": "Japan", "abbreviation": null, "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/6715.png", "badge_file": "enet/6715.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "9237", "name": "New Zealand", "short_name": "New Zealand", "abbreviation": null, "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/teambadge/new-zealand-2024.png", "badge_file": "teambadge/new-zealand-2024.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "channels": [ { "name": null, "type": "BET" } ] }, { "match_id": "1902935", "start_time": "2026-10-05T13:30:00.000Z", "status": { "code": "NS", "label": "Not started" }, "status_id": 0, "sport_id": 1, "sport": "soccer", "competition": { "competition_id": null, "stage_id": "20539", "name": "Friendlies U21", "short_name": null, "display_name": null, "slug": "friendlies-under-21", "competition_slug": null, "country": { "name": "International Friendlies", "code": "international-friendlies", "id": "576", "iso": null }, "badge_url": null, "badge_file": null, "color": null, "sport_id": 1, "sport": "soccer", "has_cup_draw": null, "is_cup": false, "feed_id": null, "feed_item_ids": [], "has_live_tracker": null, "tier_id": null }, "home": { "team_id": "9122", "name": "Ukraine U21", "short_name": "Ukraine U21", "abbreviation": null, "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/6658.png", "badge_file": "enet/6658.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "away": { "team_id": "9185", "name": "Albania U21", "short_name": "Albania U21", "abbreviation": null, "country": null, "country_code": null, "badge_url": "https://storage.livescore.com/images/team/medium/enet/5853.png", "badge_file": "enet/5853.png", "kit_url": null, "kit_file": null, "kit_goalkeeper_url": null, "kit_goalkeeper_file": null, "kit_text_color": null, "kit_goalkeeper_text_color": null, "colors": { "primary": null, "secondary": null }, "is_national": false, "sport_id": null, "sport": null, "web_path": null, "has_video": null, "has_squad": null, "is_placeholder": false }, "channels": [ { "name": null, "type": "BET" } ] } ], "listing_count": 20, "total_count": 259, "country_code": "gb", "available_in_country": true, "offset": 0, "has_more": true } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/bet-tips": { "get": { "tags": [ "Content" ], "operationId": "/bet-tips", "description": "Read community picks and trending selections for the selected sport.", "parameters": [ { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" } ], "responses": { "200": { "description": "Authored community picks and trending selections for the selected sport, with the posts and people behind them.\n\n**Editorial picks, not market offers.** A pick records what its author stated. `price_decimal` and `price_fractional`, when available, are quoted prices, not a current sportsbook offer or a settlement guarantee. Treat the posts as community opinion; there is no odds-market or bookmaker-selection API here.\n\n**Tips and posts.** Each `tips` entry has a `tip_id`, associated `topics`, an available social `post`, a stated `pick` and outbound `links`. A post can include text, public URL, ISO `published_at`, author identity/handle/avatar/follower count, engagement `metrics`, attached `media` and referenced post IDs. Missing bodies, metrics, images or link previews are null or empty; use available public URLs rather than assuming every post has an embed or preview.\n\n**Pick structure.** Use `selection_count` and `selection_ids` to understand the number of selections. Do not assume `pick.type` distinguishes a single from an accumulator: a single-selection pick can still be labeled `ACCA`. `is_resolvable` describes current selection availability, not confidence, probability or a promised result. A post without a stated pick can have `pick: null`.\n\n**Trending and topics.** `trending` groups author posts by `selection_id`. Its posts can be author stubs with null text/time/metrics; use `tips` for readable post bodies rather than expecting every trending entry to carry them. Per-tip topic tags stay on the tip. `/tipster-topics` independently supplies the catalog and available `post_count` values; join by `topic_id` when the per-tip topic count is null. Catalog counts are not tip-page totals.\n\n**Counts and coverage.** `tip_count` counts returned tips. `has_next` can indicate that more exist, but this endpoint offers no offset, limit or cursor to request another page. Sport selects the feed and defaults to `soccer`; coverage depends on active community posting, and empty tips/trending are valid for any sport. Authored text is not translated by this endpoint; `locale` is not accepted. `partial_errors` is currently empty and should not be interpreted as a second catalog dataset.\n\nThe example shows two tips and abbreviated trending posts; recorded counts are retained. Empty optional link/media arrays do not imply those fields are never populated.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "tips": [ { "tip_id": "2107034234355339588", "post": { "post_id": "2107034234355339588", "text": "Excited for this one! Ukraine U21 faces off against Albania U21, and I’m feeling like the odds don’t reflect the reality. The model gives Albania U21 a strong 70% chance to win. I'm backing them for the away win at 13:30 UTC! 🔥", "url": "https://x.com/mrsupertips/status/2107034234355339588", "type": "DEFAULT", "published_at": "2026-10-05T09:04:42.000Z", "author": { "author_id": "1688354615681552384", "name": "Mr Super Tips - Football Tips, Predictions & News", "handle": "mrsupertips", "avatar_url": "https://pbs.twimg.com/profile_images/2104703683627712512/8cWVDgdZ_normal.png", "profile_url": "https://x.com/mrsupertips", "is_verified": true, "follower_count": 4659 }, "media": [ { "type": "PHOTO", "url": "https://pbs.twimg.com/media/HT2weJfXsAAfE3N.png", "preview_url": null, "width": 768, "height": 432 } ], "metrics": { "likes": 0, "reposts": 0 }, "referenced_post_ids": [] }, "topics": [ { "topic_id": "1766567861453", "name": "#Single", "post_count": null }, { "topic_id": "1771501521131", "name": "#Football", "post_count": null } ], "pick": { "type": "ACCA", "selection_count": 1, "price_decimal": 4.2, "price_fractional": 5.25, "selection_ids": [ "SBTS_2_4362374360" ], "is_resolvable": false }, "links": [] }, { "tip_id": "2107029467419783535", "post": { "post_id": "2107029467419783535", "text": "DAILY ACCA ✍️", "url": "https://x.com/JamieFootyTip/status/2107029467419783535", "type": "DEFAULT", "published_at": "2026-10-05T08:45:46.000Z", "author": { "author_id": "1347323531198164992", "name": "👤", "handle": "JamieFootyTip", "avatar_url": "https://pbs.twimg.com/profile_images/2025165593029095424/zoboJh_p_normal.jpg", "profile_url": "https://x.com/JamieFootyTip", "is_verified": true, "follower_count": 64516 }, "media": [ { "type": "PHOTO", "url": "https://pbs.twimg.com/media/HT2sIWNWAAAcnvX.jpg", "preview_url": null, "width": 1019, "height": 1280 } ], "metrics": { "likes": 12, "reposts": 0 }, "referenced_post_ids": [] }, "topics": [ { "topic_id": "1766567810134", "name": "#Accas", "post_count": null }, { "topic_id": "1766567878301", "name": "#4-Fold", "post_count": null } ], "pick": { "type": "ACCA", "selection_count": 4, "price_decimal": 2.75, "price_fractional": 2.8, "selection_ids": [ "SBTS_2_4356953012", "SBTS_2_4358990107" ], "is_resolvable": true }, "links": [] } ], "tip_count": 5, "trending": [ { "selection_id": "SBTS_2_4358309130", "posts": [ { "post_id": "2106659002654572892", "text": null, "url": null, "type": null, "published_at": null, "author": { "author_id": "1909306187520126976", "name": "®️𝘽𝙍𝙊𝘿𝙔 𝙍𝙔𝘼𝙉 𝙋𝘼𝙍𝙇𝘼𝙔 ®️", "handle": "BRODY_parlay", "avatar_url": "https://pbs.twimg.com/profile_images/2021936841574817792/xLlKSkne_normal.jpg", "profile_url": "https://x.com/BRODY_parlay", "is_verified": true, "follower_count": 3424 }, "media": [], "metrics": null, "referenced_post_ids": [] }, { "post_id": "2106866360936505711", "text": null, "url": null, "type": null, "published_at": null, "author": { "author_id": "1297802109400866816", "name": "Tom White Football Tips", "handle": "TomWhiteTips", "avatar_url": "https://pbs.twimg.com/profile_images/1950262847444844544/dpL130J7_normal.jpg", "profile_url": "https://x.com/TomWhiteTips", "is_verified": true, "follower_count": 71540 }, "media": [], "metrics": null, "referenced_post_ids": [] } ] }, { "selection_id": "SBTS_2_4358990107", "posts": [ { "post_id": "2106659002654572892", "text": null, "url": null, "type": null, "published_at": null, "author": { "author_id": "1909306187520126976", "name": "®️𝘽𝙍𝙊𝘿𝙔 𝙍𝙔𝘼𝙉 𝙋𝘼𝙍𝙇𝘼𝙔 ®️", "handle": "BRODY_parlay", "avatar_url": "https://pbs.twimg.com/profile_images/2021936841574817792/xLlKSkne_normal.jpg", "profile_url": "https://x.com/BRODY_parlay", "is_verified": true, "follower_count": 3424 }, "media": [], "metrics": null, "referenced_post_ids": [] }, { "post_id": "2106881385495490596", "text": null, "url": null, "type": null, "published_at": null, "author": { "author_id": "1404347697067401221", "name": "DailyBetting", "handle": "DailyBettingPot", "avatar_url": "https://pbs.twimg.com/profile_images/1877007694579576832/OPE5ERFw_normal.jpg", "profile_url": "https://x.com/DailyBettingPot", "is_verified": true, "follower_count": 34630 }, "media": [], "metrics": null, "referenced_post_ids": [] } ] } ], "has_next": true, "sport": "soccer", "partial_errors": [] } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } }, "/tipster-topics": { "get": { "tags": [ "Content" ], "operationId": "/tipster-topics", "description": "Read the topic catalog for community picks in the selected sport, with topic IDs, names and published post counts.", "parameters": [ { "schema": { "type": "string", "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "enum": [ "soccer", "tennis", "hockey", "basketball", "american-football", "horses", "cricket" ], "example": "" }, "required": false, "description": "**The sport to read.** Optional; defaults to `soccer`.\n\nAccepts `soccer` (association football), `tennis`, `hockey` (ice hockey), `basketball`, `american-football`, `cricket` and `horses` (horse racing). `football` and `nfl` are not aliases for these values.\nCoverage differs by dataset. Horse-racing discovery uses `/competitions`; racing meetings are not two-sided fixtures on the day/live boards.\nCarry the sport alongside entity IDs through a workflow. `/sports` provides sport identifiers and the selected country's ordering; a supported sport does not guarantee every optional dataset.", "name": "sport", "in": "query" } ], "responses": { "200": { "description": "The topic catalog associated with community picks for the selected sport.\n\n**Topics and counts.** `topics` contains `topic_id`, a readable hashtag-style `name` and\navailable `post_count`. A null count means no count was stated, not zero. These are topic\ncatalog counts, not the number of tips returned by `/bet-tips` or a complete historical archive.\n\n**Join to picks.** `/bet-tips` returns readable picks and trending selections, with topic tags\nattached to each pick. Match `topic_id` to this catalog when a per-tip tag has no count.\nA catalog can exist even when no picks are currently available; it does not prove active\nposting or fixture coverage. Topic IDs are not match, team, competition or selection IDs.\n\n`sport` is echoed and defaults to `soccer`. The catalog can be shared or empty across sports;\ndo not assume a sport-specific vocabulary merely because a different sport was requested.\nNo locale, topic filter or paging controls are offered. Authored names retain their language.\nThe example illustrates two topic entries; an empty `topics` array is a valid result.\n\nResponse examples abbreviate long collections; counts describe the actual response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreSuccessResponseSchema" }, "example": { "success": true, "data": { "sport": "soccer", "topics": [ { "topic_id": "1766567810134", "name": "#Accas", "post_count": 24 }, { "topic_id": "1766567839106", "name": "#BetBuilder", "post_count": 1 } ] } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } }, "503": { "description": "Service temporarily unavailable — retry shortly", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveScoreErrorResponseSchema" } } } } } } } }, "servers": [ { "url": "https://rapid-api-tools-worker.pictureperfect.workers.dev/happy-endpoint/api/tools/livescore-api", "description": "Base URL" } ] }