[v2.2] Release notes

Use the examples in the notes to test endpoints directly. Use the include parameter to embed related datasets in one call (for example include=events,stats) and reduce round trips. Dataset include names are different from standalone operation selectors such as t=match_events. Use the utc parameter to get date/time values in your preferred timezone (for example utc=4 or utc=4.5).

Documentation verification (2026-09-04)

• Every operation of every route was exercised against production and the reference now lists all accepted t values per route with their parameters, response schemas and a captured example each.
• Documented operations that were missing from the reference: leaders topcards, bookmakers and markets list, referees list, venues info, rounds info; players, coaches, venues and referees lists work without country_id.
• Pagination: 100 items per page on entity lists, livescores feeds, fixtures?t=schedule and broadcast?t=schedule; per_page is not supported. Season fixtures, leaders, match datasets and search return in full.
• has_schedule and country_broadcast_id have no effect and were removed. t=multiple is not valid; use t=sort&ids=.
• Media highlights are announced but not live yet; the route is marked "coming soon".

Documentation correction (2026-08-30)

• Corrected match dataset include names to events and stats.
• Clarified that t=match_events is the standalone event operation, not an include value.
• Corrected match-by-ID and batch selectors to t=info&id=... and t=sort&ids=....
• Added the match-event response schema, scorer/assist nullability and live publication guidance.

🏟️ Venues by Season

• Venues by Season — added t=byseason to the Venues endpoint to return the venues linked to a specific season.
• Season venue data — use season_id to fetch the basic venue information from the season venue list.

Example

GET /v2.2/venues/?user=USER&token=TOKEN&t=byseason&season_id=14192

⚡ Performance & Team Kit Colors

• Performance improvements — optimized API response times and improved overall request handling for a faster experience.
• Team kit colors — added kit colors to the Teams by ID endpoint for richer team visual data.
• Minor updates — applied small fixes, refinements, and stability improvements across the API.

🛡️ API Token Usage

• API Token usage tracking — monitor token consumption, see usage by endpoint, and review historical trends.
• Token dashboard — quick overview of all tokens and their activity.
• Usage insights — identify high-traffic endpoints and optimize token allocation.

🚀 Highlights (quick glance)

• Media / highlights endpoints (beta) — fetch highlights by league, team, event, date.
• Standings Live endpoint — live/rolling standings while matches are in progress.
• Broadcast / TV improvements — TV-by-country, TV-by-match, fixtures-by-TV-channel.
• Odds enhancements — new bookmaker (Betika), per-bookmaker match odds endpoint and custom sort.
• Includes support: include events and stats inline in match-returning endpoints.
• Language additions and default images for missing entities.
• Historical data extended (up to 10 years).

📺 Broadcast & TV (new & improved)

What’s included

• TV Channels by Country (#tv_channels_country)
• All TV Channels (#tv_channels_all)
• TV Channel by ID (#tv_info)
• Improved TV Channels by Match coverage (#match_tv)
• Fixtures by TV Channel (2-week forecast) (#fixtures_tv_channel)
• TV Schedule by Date (Broadcast section)

Commentary
Use these endpoints for “Where to watch” features. You can filter broadcasts per country to show local channels only.

Example

GET /v2.2/broadcast/?user=USER&token=TOKEN&t=match_tvs&id=1910954&country_broadcast_id=5

Verification note (2026-09-04): country_broadcast_id currently has no effect; t=match_tvs returns the channels of every country.

🎞️ Media (beta)

What’s included

• Media / highlights endpoint in beta. Query by: event, league, season, team, round, date (use type=date&d=YYYY-MM-DD).

Example

GET /v2.2/media/?user=USER&token=TOKEN&t=league&id=637

Commentary
Good for editorial UIs, highlight carousels and social previews. Beta feature — expect small improvements.

Verification note (2026-09-04): the media route is not live yet and is marked "coming soon" in the reference.

📊 Standings & Live Standings

What’s included

• New endpoint: Standings Live (#standings_live) — rolling/temporary standings while matches are being played.
• number_standings added to support competitions with multiple tables (e.g., split groups).

Commentary
Use for live leaderboard views and competition pages that need in-play table updates.

⚽ Matches, Fixtures & Includes

New & improved

• related_id parameter in fixtures: track postponed / rescheduled / related events.
• info dataset added to today’s fixtures (federation decisions, special notes).
• Includes support across match-returning operations — request &include=events,stats inline in:
  • Livescores, fixture schedules, t=info (match by ID) and t=sort (multiple match IDs)
• timestamp added to today’s match events for more precise timing.
• aggregate_id and country_code added in fixtures and MatchByID endpoints.

Usage tip

GET /v2.2/fixtures/?user=USER&token=TOKEN&t=info&id=XXXX&include=events,stats

Commentary
&include= reduces roundtrips and gives richer payloads in a single call.

🧾 Players / Teams / Lineups

Added

• team_id and national_team_id on player object.
• position_name in lineups (e.g., left winger, right winger).
• market_value in player info.
• Player seasons & roles in Player by ID.
• Team seasons and extended leagues array in Team by ID.
• Basic player stats included in Match Lineups endpoint (default: formation without per-player stats; add &include=stats for full stats). Verification note (2026-09-04): include=stats returned no per-player statistics on the matches tested.

Commentary
Easier to render detailed player/team pages without additional joins. For performance, lineups omit heavy per-player stats by default.

🏟️ Venues / Coaches / Catalog

New endpoints

• Coaches by Country, All Coaches
• Venues by Country, All Venues
• All Continents, Continent by ID

Images & logos

• Logos added for 800+ leagues.
• Venue images now in PNG and available in sizes: 100, 80, 50, 18 px.

Commentary
Useful for directory pages and localized UI elements.

🔎 Search & H2H

Added

• search_all improvements: you can now search matches and TV channels.
• H2H endpoints: H2H Team vs Team and Match H2H.

Commentary
Power autocompletes and quick lookup features with the search endpoints.

🧩 Odds & Bookmakers

Added / Improved

• New bookmaker: Betika (#match_odds).
• Bookmakers custom sort (control ordering returned).
• New endpoint: Match Odds by Bookmaker.
• Markets: 1X2 (primary), Asian Handicap (AH), Over/Under (Goal Line).

Commentary
Odds coverage varies by match/popularity. Use match_odds endpoints and custom sort to prioritize affiliate/bookmaker display order.

🌐 Languages & Localization

Added languages

• Korean (ko)
• Chinese simplified (zh_cn) and Chinese (zh)
• Portuguese (pt)
• Turkish (tr)
• Polish (pl)
• French (fr)
  Beta: Arabic, Greek, Italian

Usage

...&lang=ko

Commentary
Pass &lang= to localize names and descriptions in responses.

🖼️ UX / Images / Defaults

Added

• Default images for missing leagues, teams and players (prevent broken UIs).
• Team kit colors on fixtures endpoints.
• TV channel images in four sizes (100, 80, 50, 18).

Commentary
Better visual fallback handling and consistent front-end rendering.

🔧 Improvements / Changes / Fixes

Performance / API behavior

• Match lineups now return formation without per-player stats by default to avoid latency. Add &include=stats when you need full player stats.
• Fixtures endpoints datetime values normalized to UTC.
• Standings improvements: number_standings for competitions with multiple standing groups (e.g., Indian I-League).
• Fixtures got info dataset — federation decisions and special flags included.

Other fixes

• Season Stats > goal_line recalculated/fixed.
• Historical data extended to 10 years.
• timestamp parameter added in match events for today (higher precision).
• Attendance field added.
• Aggregate_id in fixtures and MatchByID endpoints.

➕ New Endpoints (summary)

• Standings Live (#standings_live)
• Media (highlights) (beta)
• TV Channels by Country, All TV Channels, TV Channel by ID
• Fixtures Next & Last
• Match Sidelined
• Match by Multiple IDs (includes support)
• Player Stats by Match ID (#player_stats_match)
• Cup Draw (Tournament Bracket) (#cup_draw)
• Fixtures by TV Channel (2 weeks forecast)
• Match Odds by Bookmaker
• Teams National
• Team Transfers
• Team Trophies
• Search by Keyword
• Stages by Season, Stage by ID, Group by ID
• Venues by Country, All Venues
• Coaches by Country, All Coaches

🧾 Coverage & Data

• Historical data: up to 10 years available where applicable.
• Logos: +800 leagues now have logos.
• Fixtures: country_code & aggregate_id for improved grouping and filtering.

✅ Migration tips & examples

• If you use match lineups and previously relied on per-player stats, add &include=stats to your request now:

GET /v2.2/fixtures/?user=USER&token=TOKEN&t=match_lineups&id=1234&include=stats

• To fetch live standings:

GET /v2.2/leagues/?user=USER&token=TOKEN&t=standings_live&season_id=SEASON_ID

• To request media highlights (beta):

GET /v2.2/media/?user=USER&token=TOKEN&t=league&id=637

• To get richer match payloads in one call:

GET /v2.2/fixtures/?user=USER&token=TOKEN&t=info&id=XXXX&include=events,stats

📣 Final notes & recommendations

• Use &utc= for timezone-correct responses where useful (e.g., &utc=4 or &utc=4.5).
• Use &include=events,stats to avoid separate match-event and match-stat round trips. Use include=stats on t=match_lineups when full per-player lineup statistics are required.
• For heavy live polling (odds/last-minute updates), ensure your plan supports the required requests/hour.
• Media endpoints are beta — expect iterative improvements.

Read in the reference