Voti and fantavoti for every player of a matchday

GET

/v1/seasons/{seasonId}/matchdays/{number}/scores

curl --request GET \
  --url 'http://localhost:8080/v1/seasons/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/matchdays/1/scores?voto_source=provider-rating'

Parameters

Path Parameters

seasonId

required

string format: uuid

number

required

integer

>= 1

Query Parameters

voto_source

string

default: provider-rating

Where base voti come from.

Responses

200

Scores, ordered by fixture kickoff, team and player name.

Media typeapplication/json

object

settings_sha256

required

string

voto_source

required

string

scores

required

Array<object>

object

player

required

object

id

required

string

name

required

string

team

required

object

id

required

string

name

required

string

fixture_id

required

string

matchday

required

integer

role

required

string

Allowed values: goalkeeper outfield

minutes

required

integer

voto

required

Base voto; null when senza voto.

string

/^-?[0-9]+\.[0-9]{2}$/

fantavoto

required

Voto plus the sum of the breakdown; null when senza voto.

string

/^-?[0-9]+\.[0-9]{2}$/

senza_voto

required

boolean

voto_ufficio

required

The voto was assigned by a senza voto rule

boolean

stats

required

What the player did in the match, as derived from provider events. Shoot-outs never count.

object

goals

required

Goals scored, excluding penalties

integer

penalties_scored

required

integer

penalties_missed

required

Penalties taken and not scored, including those saved by the keeper

integer

penalties_saved

required

Penalties saved, as the goalkeeper

integer

own_goals

required

integer

assists

required

Every assist class together

integer

assists_set_piece

required

Assists that came from a set piece. Part of assists; the rest are open play

integer

assists_contribution

required

Contributions to a goal that were not judged assists. Part of assists

integer

yellow_cards

required

Includes a second yellow

integer

sent_off

required

Sent off by a straight red or a second yellow

boolean

goals_conceded

required

Goals the player’s team conceded while the player was on the pitch, own goals included

integer

decisive_goals_win

required

1 for the goal that put the winner ahead for good (the winner’s goal number loser+1, regulation time, goals and penalty goals only; an own goal credits nobody)

integer

<= 1

decisive_goals_draw

required

1 for the last goal of a drawn match with goals, the one that levelled the score (regulation time; an own goal credits nobody)

integer

<= 1

player_of_the_match

required

Named man of the match by the provider. Many fixtures have none

boolean

clean_sheet

required

Goalkeeper who played and whose team conceded no goal while they were on the pitch. Whether it earned the bonus is in the breakdown (gk_clean_sheet): none when the voto is a voto d’ufficio or under the league’s minimum minutes

boolean

breakdown

required

Array<object>

object

code

required

A scoring code

string

count

required

integer

>= 1

points

required

string

/^-?[0-9]+\.[0-9]{2}$/

run

required

object

id

required

string

settings_sha256

required

string

voto_source

required

string

computed_at

required

string format: date-time

Example

{
  "scores": [
    {
      "role": "goalkeeper",
      "voto": "6.38",
      "fantavoto": "6.38",
      "breakdown": [
        {
          "code": "goal",
          "points": "6.38"
        }
      ]
    }
  ]
}

400

An error, as RFC 9457 problem details.

Media typeapplication/problem+json

object

type

required

string

title

required

string

status

required

integer

detail

string

Example

{
  "type": "about:blank"
}

404

An error, as RFC 9457 problem details.

Media typeapplication/problem+json

object

type

required

string

title

required

string

status

required

integer

detail

string

Example

{
  "type": "about:blank"
}