A
A
API 3.0 (BETA)
Search…
πŸ†•
What's new?
Check this video out to see what's new in API 3.0?

Updated syntax

;can be used for adding multiple includes. For example, you want the stats of a certain season. In this case you would use participant;events
: can be used for filtering the fields you want to see in the response. For example, you only want the name of a certain team. You need to use participant:name
Alright, but I want more than the name of a team.
, can be used for adding another field to an include. For example, you want the teamname and gender of that team. You will use participant:name,gender

New Endpoints

Available in core:
  • Types endpoint (available in core)
    • All Types
    • Type By ID
  • My endpoints (to check your own data features)
    • Data Features endpoint
      • My Data Features
    • Endpoints
      • My Endpoints
    • Leagues
      • My League
  • Search endpoints for all entities with a name field
  • Extra endpoints for each entity

New Data Features

  • Offsides events for major leagues
  • Shots on/off target events for major leagues
  • Placeholder games available (finals etc)
  • Ball coordinates (semi live)
  • Forecast weather report
  • More predictions
  • Predictive lineup (Beta)
  • Coach statistics
  • Period statistics
  • More statistics in general

Detailed position

It is now possible to find out if a defender is a full back or centre back based on the detailed position ID.
https://api.sportmonks.com/v3/football/fixtures/18453058?api_token={your_token}&includes=lineups.position

Data Features per league

There is a new endpoint for Leagues /{id}/enrichment that shows what kind of data features a league has. For example, if the league has lineups.

States and types

We introduced states and types to ensure data quality and consistency for specific fields.
For example, states for fixtures.
Position ID and detailed position ID are new types. Also, markets, periods, sidelined, referees, events, standings, metadata, formation, colours, injuries, suspensions, predictions, and stats.

Select the fields you need

You can request only the fields you need by using the new syntax.
: can be used for filtering the fields you want to see in the response. For example, you only want the name of a certain team. You need to use participant:name

League priority

You can now prioritize the leagues you want to view. This means you can order the leagues the way you want.

Strict typing

Strictly typed languages enforce typing on all data being interacted with. For example int i = 3 string s = "4". In our API all fields are typed the same way.
Changelog updates after the Beta will be documented in the changelog.
Copy link
Outline
Updated syntax
New Endpoints
New Data Features
Detailed position
Data Features per league
States and types
Select the fields you need
League priority
Strict typing