Common Data Format - Official Match Data

Type: object

Version 0.2.2

This schema defines the Official Match Data as described in the Common Data Format paper.

root match
Type: object

root match id
Type: string

Unique match identifier

root match status
Type: object

root match status is_neutral
Type: boolean

Denotes whether the game was hosted in a neutral venue (true) or not (false)

root match status has_extratime
Type: boolean

Denotes whether the game went to extra time (true) or not (false)

root match status has_shootout
Type: boolean

Denotes whether the game had a penalty shootout (true) or not (false)

root match result

root match result allOf item 0
Type: object

If the conditions in the "If" tab are respected, then the conditions in the "Then" tab should be respected. Otherwise, the conditions in the "Else" tab should be respected.

root match result allOf item 0 if
Type: object

root match result allOf item 0 if has_extratime
Type: const
Specific value: true
root match result allOf item 0 then
Type: object

The following properties are required:

  • first_half_extratime
  • second_half_extratime
root match result allOf item 1
Type: object

If the conditions in the "If" tab are respected, then the conditions in the "Then" tab should be respected. Otherwise, the conditions in the "Else" tab should be respected.

root match result allOf item 1 if
Type: object

root match result allOf item 1 if has_shootout
Type: const
Specific value: true
root match result allOf item 1 then
Type: object

The following properties are required:

  • shootout

root match result final
Type: object

root match result final home
Type: integer

Final result for home team

root match result final away
Type: integer

Final result for away team

root match result final_winning_team_id
Type: string

Unique identifier of the winning team

root match result first_half
Type: object

root match result first_half home
Type: integer

First half result for home team

root match result first_half away
Type: integer

First half result for away team

root match result second_half
Type: object

root match result second_half home
Type: integer

Second half result for home team

root match result second_half away
Type: integer

Second half result for away team

root match result first_half_extratime
Type: object

Required if has_extratime is true

root match result first_half_extratime home
Type: integer

First half extratime result for home team

root match result first_half_extratime away
Type: integer

First half extratime result for away team

root match result second_half_extratime
Type: object

Required if has_extratime is true

root match result second_half_extratime home
Type: integer

Second half extratime result for home team

root match result second_half_extratime away
Type: integer

Second half extratime result for away team

root match result shootout
Type: object

Required if has_shootout is true

root match result shootout home
Type: integer

Shootout result for home team

root match result shootout away
Type: integer

Shootout result for away team

root teams
Type: object

root teams home
Type: object

root teams home id
Type: string

Unique identifier for the team

root teams home short_name
Type: string

Short name of the team

root teams home formation
Type: string

Formation label of the team (e.g. '4-4-2')

root teams home players
Type: array of object
No Additional Items

Each item of this array must be:

root teams home players players items
Type: object

root teams home players players items id
Type: string

Unique player identifier

root teams home players players items first_name
Type: string

First name

root teams home players players items last_name
Type: string

Last name

root teams home players players items short_name
Type: string

Short name

root teams home players players items team_id
Type: string

Unique team identifier denoting the team the player plays for

root teams home players players items jersey_number
Type: integer

Jersey number for a player

root teams home players players items is_starter
Type: boolean

Denotes whether a player started the game (true) or not (false)

root teams home players players items has_played
Type: boolean

Denotes whether a player played in game (true) or not (false)

root teams home players players items maiden_name
Type: string

Maiden name

root teams home players players items position_group
Type: enum (of string)

Position group acronym given according to the CDF-compatible groups

Must be one of:

  • "GK"
  • "DF"
  • "MF"
  • "FW"
  • "SUB"

root teams home players players items position
Type: enum (of string)

Position label acronym per player given according to the CDF-compatible labels

Must be one of:

  • "GK"
  • "LB"
  • "LCB"
  • "CB"
  • "RCB"
  • "RB"
  • "LDM"
  • "CDM"
  • "RDM"
  • "LM"
  • "LCM"
  • "CM"
  • "RCM"
  • "RM"
  • "LAM"
  • "CAM"
  • "RAM"
  • "LW"
  • "LCF"
  • "CF"
  • "RCF"
  • "RW"
  • "SUB"

root teams home players players items is_captain
Type: boolean

Whether the player is a captain (true) or not (false)

root teams home players players items date_of_birth
Type: stringFormat: date

A player's date of birth in YYYY-MM-DD format

Must match regular expression: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$

root teams home players players items height
Type: integer

Height of a player in cm

root teams home players players items foot
Type: enum (of string)

A player's dominant foot, which can take the values left, right or both

Must be one of:

  • "left"
  • "right"
  • "both"

root teams home players players items alternative_id
Type: string

Additional identifier(s) of the player

root teams home coaches
Type: array of object
No Additional Items

Each item of this array must be:

root teams home coaches coaches items
Type: object

root teams home coaches coaches items id
Type: string

Unique identifier for a coach

root teams home coaches coaches items first_name
Type: string

First name

root teams home coaches coaches items last_name
Type: string

Last name

root teams home coaches coaches items short_name
Type: string

Short name

root referees
Type: array of object
No Additional Items

Each item of this array must be:

root referees referees items
Type: object

root referees referees items id
Type: string

Unique referee identifier

root referees referees items official_type
Type: string

The type of referee (e.g. videoassistantreferee, mainreferee, assistantreferee or fourth_official

root referees referees items first_name
Type: string

First name

root referees referees items last_name
Type: string

Last name

root referees referees items short_name
Type: string

Short name

root events
Type: object

root events goals
Type: array of object or null
No Additional Items

Each item of this array must be:

root events goals goals items
Type: object

root events goals goals items time
Type: stringFormat: date-time

Time a player scored

root events goals goals items period
Type: enum (of string)

Period of the game when the goal was scored

Must be one of:

  • "first_half"
  • "second_half"
  • "first_half_extratime"
  • "second_half_extratime"
  • "shootout"

root events goals goals items team_id
Type: string

Identifier of the team who scored

root events goals goals items player_id
Type: string

Identifier of the player who scored

root events goals goals items assist_id
Type: string or null

Identifier of the player who assisted

root events goals goals items is_own_goal
Type: boolean

Denotes whether it was an own goal (true) or not (false)

root events goals goals items is_penalty
Type: boolean

Denotes whether it was a penalty (true) or not (false)

root events goals goals items score
Type: object

root events goals goals items score home
Type: integer

Home team score after this goal

root events goals goals items score away
Type: integer

Away team score after this goal

root events substitutions
Type: array of object or null
No Additional Items

Each item of this array must be:

root events substitutions substitutions items
Type: object

root events substitutions substitutions items team_id
Type: string

Identifier of the team who scored

root events substitutions substitutions items in_time
Type: stringFormat: date-time

Time a player is substituted in

root events substitutions substitutions items period
Type: enum (of string)

Period of the game when the substitution occurred

Must be one of:

  • "first_half"
  • "second_half"
  • "first_half_extratime"
  • "second_half_extratime"

root events substitutions substitutions items in_player_id
Type: string

Identifier of the player that is substituted in

root events substitutions substitutions items out_time
Type: stringFormat: date-time

Time a player is substituted out

root events substitutions substitutions items out_player_id
Type: string

Identifier of the player that is substituted out

root events cards
Type: array of object or null
No Additional Items

Each item of this array must be:

root events cards cards items
Type: object

root events cards cards items team_id
Type: string

Identifier of the team who scored

root events cards cards items time
Type: stringFormat: date-time

Time a player received a card

root events cards cards items period
Type: enum (of string)

Period of the game when the card was shown

Must be one of:

  • "first_half"
  • "second_half"
  • "first_half_extratime"
  • "second_half_extratime"

root events cards cards items player_id
Type: string

Identifier of the player who received a card

root events cards cards items type
Type: enum (of string)

Type of card which can be yellow card, red card or second yellow card

Must be one of:

  • "yellow_card"
  • "red_card"
  • "second_yellow_card"

root meta
Type: object

root meta vendor
Type: string

Match sheet data vendor name