Links

Other

News

Field Description

Field
Text
Type
id
Refers to the unique id of the news article
integer
fixture_id
Refers to the fixture related to the news article
integer
league_id
Refers to the league related to the news article
integer
title
The title of the news article
string
type
The type of the news
string
published_at
The date of publishing of the news article
string

Include options

NewsItemLine

Field Description

Field
Text
Type
id
Refers to the unique id of the news article line
integer
newsitem_id
Refers to the news article related to the news article line
integer
text
The text of the news article line
string
type
The type of the news article line
string

Include options

none

Commentary

Field Description

Field
Text
Type
id
Refers to the unique id of the commentary
string
fixture_id
Refers to the fixture related to the commentary
integer
comment
The textual representation of the event in the fixture
string
minute
The minute of the comment in the fixture
integer
extra_minute
The extra minute of the comment in the fixture
integer
is_goal
Indicates if the comment is a goal
boolean
is_important
Indicates if the comment is important
boolean
order
The order of the comment
integer

Include options

Video Highlight

Field Description

Field
Text
Type
id
Refers to the id of the video highlight
integer
fixture_id
Refers to the fixture related to the video highlights
integer
type_id
Refers to the type related to the video highlights
integer
event_id
Refers to the event related to the video highlights
integer
location
Returns the location URL of the video highlight
string

Include options

fixture

TvStation

Field Description

Field
Text
Type
id
Refers to the unique id of the tv station
integer
name
Displays the name of the tv station
string
url
Displays the url of the tv station
string / null
image_path
Displays the image path of the tv station
string / null

Include options

Venue

Field description

Field
Description
Type
id
Refers to the unique id of the venue
integer
country_id
Refers to the country of the venue
integer
name
Returns the name of the venue
string
address
Returns the address of the venue
string
zipcode
Returns the zipcode of the venue
string
state
Returns the state of the venue
string / null
latitude
Returns the latitude of the venue
string
longitude
Returns the longitude of the venue
string
capacity
Returns the seating capacity of the venue
integer
image_path
Returns the image path of the venue
string / null
city_name
Returns the name of the city the venue is located in
string
surface
Returns the surface type of the venue
string
national_team
Indicates if the venue is used for the national team of the country
boolean

Include options

WeatherReport

Field description

Field
Description
Type
id
Refers to the unique id of the weather report
integer
fixture_id
Refers to the fixture related to the weather report
integer
venue_id
Refers to the venue related to the weather report
integer
temperature
Displays the temperatures over the day
object
feels_like
Displays the perceived temperatures over the day
object
wind
Displays the wind speed and direction
object
humidity
Displays the degree of humidity of the weather report
string
pressure
Displays the pressure of the weather report
integer
clouds
Displays the degree of clouds of the weather report
string
description
Displays the description of the weather report
string
icon
Displays the Sportmonks icon related to the weather report
string
type
Displays the type of the weather report
string
metric
Displays the metric of temperature of the weather report
string

Include options

Transfer

Related endpoints
Field Description
Field
Description
Type
id
Refers to the id of the transfer
integer
sport_id
Refers to the sport related to the transfer
integer
player_id
Refers to the player related to the transfer
integer
type_id
Refers to the type of the transfer
integer
from_team_id
Refers to the team the player transferred from
integer
to_team_id
Refers to the team the player transferred to
integer
position_id
Refers to the position of the player
integer
detailed_position_id
Refers to the detailed position of the player
integer
date
Displays the date of the transfer
string
career_ended
Indicates if the player has ended his career
integer
amount
Displays the amount of the transfer
string
completed
Indicates if the transfer is completed or not
boolean
completed_at
Displays the date time of when the transfer has been completed
string

Include options

Transfer Entity Filters

Query Parameters
Static Filters
Dynamic Filters
Query Parameters
Required
Description
api_token
YES Another option is to provide the API token in the header.
Your unique API token. Ex. ?api_token={{YOURTOKEN}}
include
NO
Enrich the API response with more data by using includes. Ex. &include=type;fromTeam
select
NO
Select specific fields on the base entity
filters
NO
Filter the API response on multiple related entities. There are static filters and dynamic filters.​Please find the possibilities in the Static and Dynamic Filter tab.
No Static Filters available for this entity, beside the Get All Transfers endpoint where you can use the idAfter filter
The dynamic filters are based on entities and includes. Each dynamic filter uses an entity to filter on and one entity to apply the filter on. Below are examples with explanations of how filters are set up. For more information, please look at our Filters page.
Dynamic Filters
Available on Entity
Description
Examples
types
Statistics, Events, Lineup, Transfers and way more. Check this endpoint for all possibilities.
Filter the Types on a selection of Transfers separated by a comma.
&include=type&filters=transferTypes:TypeIDs
&include=type&filters=transferTypes:219,220

Rival

Related endpoints
Field Description
Field
Description
Type
sport_id
Refers to the sport of the rival
integer
team_id
Refers to the team of the team
integer
rival_id
Refers to the team of the rival of the team
integer

Include options

MetaData

Field Description
Field
Description
Type
id
Refers to the id of the meta data object
integer
metadatable_type
Displays the type of the related meta data object
string
metadatable_id
Refers to the id of the related meta data object
integer
type_id
Refers to the type of the meta data object
integer
value
Displays the values of the meta data object
mixed
value_type
Displays the type of the value
string

Include options

type

State

Related endpoints
Field Description
Field
Description
Type
id
Refers to the id of the state
integer
state
Displays the state of the state
string
name
Displays the full name of the state
string
short_name
Displays the short name of the state
string
developer_name
Displays the developer name of the state
string
is_live
Indicates if the state is a live state
boolean
is_pending
Indicates if the state is a pending state
boolean
is_period_end
Indicates if the state is a period end state
boolean
is_final_state
Indicates if the state is a final state
boolean
is_cancelled
Indicates if the state is a cancelled state
boolean
is_final_standing_state
Indicates if the state is a final standing state
boolean
is_completed
Indicates if the state is a completed state
boolean

Include options

type

ParticipantTrophy

Field Description
Field
Description
Type
id
Refers to the id of the participant trophy
integer
participant_id
Refers to the id of the related participant
integer
team_id
Refers to the id of the related team of the participant
integer
league_id
Refers to the id of the related league
integer
season_id
Refers to the id of the related season
integer
trophy_id
Refers to the id of the related trophy
integer

Include options

Trophy

Field Description
Field
Description
Type
id
Refers to the id of the trophy
integer
sport_id
Refers to the id of the related sport
integer
position
Displays the position of the trophy
integer
name
Displays the name of the trophy (eg. Winner)
integer

Include options

none

Social

Field Description
Field
Description
Type
id
Refers to the id of the social
integer
social_id
Refers to the id of the related entity of the social
integer
social_channel_id
Refers to the id of the related channel of the social
integer
value
Displays the value of the social (eg. account name)
string

Include options

channel

SocialChannel

Field Description
Field
Description
Type
id
Refers to the id of the social channel
integer
name
Displays the name of the social channel
string
base_url
Displays the url of the social channel
string
hex_color
Displays the main color of the social channel
string

Include options

none