Links
📄

Changelog

Since the release of API3 and onwards, we will list any additions and changes made in the API on this page, in chronological order (YYYY-MM-DD format)

2023-09-21

  • A new event type has been implemented which tracks VAR checks related to cards. From today onwards all VAR events that are related to cards are covered under the VAR_CARD event type.
Example
{
"id": 90673921,
"fixture_id": 18867346,
"period_id": 4993000,
"participant_id": 7790,
"type_id": 1697,
"section": "event",
"player_id": 435939,
"related_player_id": null,
"player_name": "Federico Baschirotto",
"related_player_name": null,
"result": null,
"info": null,
"addition": "Redcard confirmed",
"minute": 56,
"extra_minute": null,
"injured": null,
"on_bench": false,
"coach_id": null,
"sub_type_id": null,
"type": {
"id": 1697,
"name": "VAR_CARD",
"code": "VAR_CARD",
"developer_name": "VAR_CARD",
"model_type": "event",
"stat_group": null
}
},

2023-09-13

  • An endpoint for insights into your API usage has been added. This endpoint will return your usage aggregated per endpoint per 5 minutes. You may for example use this endpoint to build your own monitoring dashboards, or to gain insights into how you can optimize your traffic to our API by spreading your usage. 📊💻

2023-09-06

  • Both Referee and Coach entities now offer the possibility to add the latest include. The include providers their latest fixtures records from the past 6 months.

2023-09-04

  • When available, a code field has been added to the API error response, these errors include a link to our documentation pages where the errors are explained more briefly. The code corresponds to one of the entries in the listed table.
Errors now contain a code attribute when available.
  • When using the statistics include on a Season, using the nested Type include caused the original type field for the object to be overridden. To prevent this behaviour from happening, the relational Type object will now be available under the statistic_type attribute.
    Type object now available under statistic_type attribute.

2023-08-15

  • TV station BT Sport has been renamed to TNT Sports due to rebranding. (affecting ID 46 and 860). TNT Sports 2, 3, 4 are newly added under ID 928, 929, 930.

2023-07-18

2023-06-08

  • Endpoints for retrieving statistics have been added. These allow you to easily retrieve statistics for specific seasons, stages, or rounds, instead of having to propagate through includes to retrieve them.
  • A new include called 'currentPeriod' has been added. It allows for retrieval of the inplay period in a more convenient way compared to using the periods include. Please note the include may return NULL. For example when the match has not yet started, is in half-time, or has ended.
  • The PlayerStatistic entity now contains a has_values field, indicating whether a Player has any statistics available for the given season.
  • We have renamed the BEATS type to SUCCESSFUL_DRIBBLES to better reflect the type of statistic.
A tutorial which covers all the new features added with this release
​

2023-05-31

2023-05-30

  • We have added the currentPeriod include. You can use this as a more convenient way to get the current inplay period for a fixture. Note that the result can be null, for example when the fixture itself is not inplay or the fixture is currently in half-time break.

2023-05-17

  • The Multiple Fixtures by Id endpoint now allows a maximum of 50 unique id's, this reflects the maximums (per_page) we allow on default paginated endpoints.

2023-04-28

  • The developer name of Type "Screwsnails Removal" (id: 830) has been renamed to SCREWS_NAILS_REMOVAL for naming convention.

2023-04-18

As per an earlier announcement, we have released some changes to the API on this date.

Removed fields:

  • State: is_live, is_pending, is_period_end, is_final_state, is_cancelled, is_final_standing_state, is_completed, type_id, is_deleted, is_notstarted, period_length_setting, deactivate_inplay
  • Period: period_length_internal, final_minute, home_score, away_score
  • Fixture: last_processed_at

Renamed fields:

  • Squad: yersey_number was renamed to jersey_number
Added fields:
  • League: category (basic tier like indicator for the size / popularity of the league. Ranges from 1-4, where 1 are the most 'popular' leagues.
Ordering on endpoints:
  • Paginated endpoints now support ordering, you can pass a query parameter order with your request to indicate the desired order. Currently order=desc and order=asc are supported. Visit the documentation of the endpoint you are wishing to use ordering on to obtain the field that the ordering applies on.
https://api.sportmonks.com/v3/football/fixtures?api_token=YOUR_TOKEN&page=2&order=desc
Threshold adjustments:
  • The threshold of the Latest Updated Fixtures endpoint was lowered from 5 minutes, to 10 seconds. The previous threshold of 5 minutes fetched too much results at times, causing requests to time out.
​
​